C/C++ SDK

{"value":"\u672c SDK \u4f7f\u7528\u7b26\u5408 C89 \u6807\u51c6\u7684 C \u8bed\u8a00\u5b9e\u73b0\u3002\u7531\u4e8e C \u8bed\u8a00\u7684\u666e\u9002\u6027\uff0c\u539f\u5219\u4e0a\u6b64 SDK \u53ef\u4ee5\u8de8\u6240\u6709\u4e3b\u6d41\u5e73\u53f0\uff0c\u4e0d\u4ec5\u53ef\u4ee5\u76f4\u63a5\u5728 C \u548c C++ \u7684\u5de5\u7a0b\u4e2d\u4f7f\u7528\uff0c\u4e5f\u53ef\u4ee5\u7528\u4e8e\u4e0e C \u8bed\u8a00\u4ea4\u4e92\u6027\u8f83\u597d\u7684\u8bed\u8a00\u4e2d\uff0c\u4f8b\u5982 C#\uff08\u4f7f\u7528 P\/Invoke \u4ea4\u4e92\uff09\u3001Java\uff08\u4f7f\u7528 JNI \u4ea4\u4e92\uff09\u3001Lua \u7b49\u3002\n\n\u672c\u5f00\u53d1\u6307\u5357\u5047\u8bbe\u5f00\u53d1\u8005\u4f7f\u7528\u7684\u5f00\u53d1\u8bed\u8a00\u662f C\/C++\uff0cC-SDK \u4ee5\u5f00\u6e90\u65b9\u5f0f\u63d0\u4f9b\u3002\u5f00\u53d1\u8005\u53ef\u4ee5\u4ece\u672c\u6587\u6863\u63d0\u4f9b\u7684\u4e0b\u8f7d\u5730\u5740\u67e5\u770b\u548c\u4e0b\u8f7d SDK \u7684\u6e90\u4ee3\u7801\uff0c\u5e76\u6309\u81ea\u5df1\u7684\u5de5\u7a0b\u73b0\u72b6\u8fdb\u884c\u5408\u7406\u4f7f\u7528\uff0c\u4f8b\u5982\u7f16\u8bd1\u4e3a\u9759\u6001\u5e93\u6216\u8005\u52a8\u6001\u5e93\u540e\u8fdb\u884c\u94fe\u63a5\uff0c\u6216\u8005\u76f4\u63a5\u5c06 SDK \u7684\u6e90\u4ee3\u7801\u52a0\u5165\u5230\u81ea\u5df1\u7684\u5de5\u7a0b\u4e2d\u4e00\u8d77\u7f16\u8bd1\uff0c\u4ee5\u4fdd\u6301\u5de5\u7a0b\u8bbe\u7f6e\u7684\u7b80\u5355\u6027\u3002\n\n- [C\/C++ SDK \u6e90\u7801\u5730\u5740](https:\/\/github.com\/CDNCloudForU\/c-sdk)\n- [C\/C++ SDK Demo](https:\/\/github.com\/CDNCloud-com\/c-sdk\/tree\/master\/examples)\n\n\u4ece v5.0.0 \u7248\u672c\u5f00\u59cb\uff0c\u6211\u4eec\u5bf9 SDK \u7684\u5185\u5bb9\u8fdb\u884c\u4e86\u7cbe\u7b80\u3002\u6240\u6709\u7ba1\u7406\u64cd\u4f5c\uff0c \u4f8b\u5982\u521b\u5efa\/\u5220\u9664 bucket\uff0c\u4e3a bucket \u7ed1\u5b9a\u57df\u540d (publish)\uff0c\u8bbe\u7f6e\u6570\u636e\u5904\u7406\u7684\u6837\u5f0f\u5206\u9694\u7b26\uff0c\u65b0\u589e\u6570\u636e\u5904\u7406\u6837\u5f0f\u7b49\u90fd\u53bb\u9664\u4e86\uff0c\u5efa\u8bae\u7edf\u4e00\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u5b8c\u6210\u3002\u53e6\u5916\uff0c\u6b64\u524d\u670d\u52a1\u7aef\u8fd8\u6709\u81ea\u5df1\u72ec\u6709\u7684\u4e0a\u4f20 API\uff0c\u73b0\u5728\u4e5f\u63a8\u8350\u7edf\u4e00\u6210\u57fa\u4e8e\u5ba2\u6237\u7aef\u4e0a\u4f20\u7684\u5de5\u4f5c\u65b9\u5f0f\u3002\n\n\u4ece\u5185\u5bb9\u4e0a\u6765\u8bf4\uff0cC-SDK \u4e3b\u8981\u5305\u542b\u5982\u4e0b\u51e0\u65b9\u9762\u7684\u5185\u5bb9\uff1a\n\n- \u516c\u5171\u90e8\u5206\uff0c\u6240\u6709\u60c5\u51b5\u4e0b\u90fd\u7528\u5230\uff1aqiniu\/base.c\u3001qiniu\/conf.c\u3001qiniu\/http.c\n- \u5ba2\u6237\u7aef\u4e0a\u4f20\u6587\u4ef6\uff1aqiniu\/base_io.c\u3001qiniu\/io.c\n- \u5ba2\u6237\u7aef\u65ad\u70b9\u7eed\u4e0a\u4f20\uff1aqiniu\/base_io.c\u3001qiniu\/io.c\u3001qiniu\/multipart_upload.c\n- \u670d\u52a1\u7aef\u64cd\u4f5c\uff1aqiniu\/auth_mac.c\uff08\u6388\u6743\uff09\uff0cqiniu\/rs.c\uff08\u8d44\u6e90\u7ba1\u7406\uff0c\u4e0a\u4f20\u51ed\u8bc1 uptoken\/\u4e0b\u8f7d\u51ed\u8bc1 dntoken \u751f\u6210\uff09\n\n\n\n# \u5b89\u88c5\n\nC-SDK \u4f7f\u7528[cURL](http:\/\/curl.haxx.se\/)\u8fdb\u884c\u7f51\u7edc\u76f8\u5173\u64cd\u4f5c\u3002\u65e0\u8bba\u662f\u4f5c\u4e3a\u5ba2\u6237\u7aef\u8fd8\u662f\u670d\u52a1\u7aef\uff0c\u90fd\u9700\u8981\u4f9d\u8d56 cURL\u3002\u5982\u679c\u4f5c\u4e3a\u670d\u52a1\u7aef\uff0cC-SDK \u56e0\u4e3a\u9700\u8981\u7528 HMAC \u8fdb\u884c\u6570\u5b57\u7b7e\u540d\u505a\u6388\u6743\uff08\u7b80\u79f0\u7b7e\u540d\u6388\u6743\uff09\uff0c\u6240\u4ee5\u4f9d\u8d56\u4e86[OpenSSL](http:\/\/www.openssl.org\/)\u5e93\u3002C-SDK \u5e76\u6ca1\u6709\u5e26\u4e0a\u8fd9 2 \u4e2a\u5916\u90e8\u5e93\uff0c\u56e0\u6b64\u5728\u4f7f\u7528 C-SDK \u4e4b\u524d\uff0c\u9996\u5148\u786e\u8ba4\u60a8\u7684\u5f53\u524d\u5f00\u53d1\u73af\u5883\u4e2d\u662f\u5426\u5df2\u7ecf\u5b89\u88c5\u4e86\u8fd9 2 \u4e2a\u5916\u90e8\u5e93\uff0c\u7136\u540e\u68c0\u67e5\u8fd9 2 \u4e2a\u5916\u90e8\u5e93\u7684\u5934\u6587\u4ef6\u76ee\u5f55\u548c\u5e93\u6587\u4ef6\u76ee\u5f55\u662f\u5426\u90fd\u5df2\u7ecf\u52a0\u5165\u5230\u4e86\u9879\u76ee\u5de5\u7a0b\u7684\u8bbe\u7f6e\u3002\n\n\u5728\u4e3b\u6d41\u7684 *nix \u73af\u5883\u4e0b\uff0c\u901a\u5e38[cURL](http:\/\/curl.haxx.se\/)\u548c[OpenSSL](http:\/\/www.openssl.org\/)\u90fd\u5df2\u7ecf\u968f\u7cfb\u7edf\u9ed8\u8ba4\u5b89\u88c5\u5230\u4e86 \/usr\/include \u548c \/usr\/lib \u76ee\u5f55\u4e0b\u3002\u5982\u679c\u60a8\u7684\u7cfb\u7edf\u8fd8\u6ca1\u6709\u8fd9\u4e9b\u5e93\uff0c\u8bf7\u81ea\u884c\u5b89\u88c5\u3002\n\n\u5982\u679c\u4f60\u4f7f\u7528 gcc \u8fdb\u884c\u7f16\u8bd1\uff0c\u670d\u52a1\u7aef\u5178\u578b\u7684\u94fe\u63a5\u9009\u9879\u662f\uff1a-lcurl -lssl -lcrypto -lm\uff0c\u5ba2\u6237\u7aef\u5219\u662f\uff1a-lcurl -lm\u3002\n\n\u5982\u679c\u5728\u9879\u76ee\u6784\u5efa\u8fc7\u7a0b\u4e2d\u51fa\u73b0\u73af\u5883\u76f8\u5173\u7684\u7f16\u8bd1\u9519\u8bef\u548c\u94fe\u63a5\u9519\u8bef\uff0c\u8bf7\u786e\u8ba4\u8fd9\u4e9b\u9009\u9879\u662f\u5426\u90fd\u5df2\u7ecf\u6b63\u786e\u914d\u7f6e\uff0c\u4ee5\u53ca\u6240\u4f9d\u8d56\u7684\u5e93\u662f\u5426\u90fd\u5df2\u7ecf\u6b63\u786e\u5b89\u88c5\u3002\n\n**ACCESS_KEY \u548c SECRET_KEY**\n\n\u5982\u679c\u4f60\u7684\u670d\u52a1\u7aef\u91c7\u7528 C-SDK\uff0c\u90a3\u4e48\u4f7f\u7528 C-SDK \u524d\uff0c\u60a8\u9700\u8981\u62e5\u6709\u4e00\u5bf9\u6709\u6548\u7684 AccessKey \u548c SecretKey \u7528\u6765\u8fdb\u884c\u7b7e\u540d\u6388\u6743\u3002\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. \u767b\u5f55\u79c1\u6709\u4e91\u5b58\u50a8\u5f00\u53d1\u8005\u5e73\u53f0\uff0c\u67e5\u770b Access Key \u548c Secret Key\n\nC-SDK \u7684 conf.h \u6587\u4ef6\u4e2d\u58f0\u660e\u4e86\u5bf9\u5e94\u7684\u4e24\u4e2a\u53d8\u91cf\uff1aQINIU_ACCESS_KEY \u548c QINIU_SECRET_KEY\u3002\u60a8\u9700\u8981\u5728\u542f\u52a8\u7a0b\u5e8f\u4e4b\u521d\u521d\u59cb\u5316\u8fd9\u4e24\u4e2a\u53d8\u91cf\u4e3a\u79c1\u6709\u4e91\u5b58\u50a8\u9881\u53d1\u7684 AccessKey \u548c SecretKey\u3002\n\n**\u521d\u59cb\u5316**\n\n\u5bf9\u4e8e\u670d\u52a1\u7aef\u800c\u8a00\uff0c\u5e38\u89c4\u7a0b\u5e8f\u6d41\u7a0b\u662f\uff1a\n\n```cpp\nQiniu_Client client;\n\nQINIU_ACCESS_KEY = \"<Please apply your access key>\";\nQINIU_SECRET_KEY = \"<Dont send your secret key to anyone>\";\n\nQiniu_Servend_Init(-1); \/* \u5168\u5c40\u521d\u59cb\u5316\u51fd\u6570\uff0c\u6574\u4e2a\u8fdb\u7a0b\u53ea\u9700\u8981\u8c03\u7528\u4e00\u6b21 *\/\nQiniu_Client_InitMacAuth(&client, 1024, NULL); \/* HTTP\u5ba2\u6237\u7aef\u521d\u59cb\u5316\u3002HTTP\u5ba2\u6237\u7aef\u662f\u7ebf\u7a0b\u4e0d\u5b89\u5168\u7684\uff0c\u4e0d\u8981\u5728\u591a\u4e2a\u7ebf\u7a0b\u95f4\u5171\u7528 *\/\n\n...\n\nQiniu_Client_Cleanup(&client); \/* \u6bcf\u4e2aHTTP\u5ba2\u6237\u7aef\u4f7f\u7528\u5b8c\u540e\u91ca\u653e *\/\nQiniu_Servend_Cleanup(); \/* \u5168\u5c40\u6e05\u7406\u51fd\u6570\uff0c\u53ea\u9700\u8981\u5728\u8fdb\u7a0b\u9000\u51fa\u65f6\u8c03\u7528\u4e00\u6b21 *\/\n```\n\n\u5bf9\u4e8e\u5ba2\u6237\u7aef\u800c\u8a00\uff0c\u5e38\u89c4\u7a0b\u5e8f\u6d41\u7a0b\u662f\uff1a\n\n```cpp\nQiniu_Client client;\n\nQiniu_Global_Init(-1); \/* \u5168\u5c40\u521d\u59cb\u5316\u51fd\u6570\uff0c\u6574\u4e2a\u8fdb\u7a0b\u53ea\u9700\u8981\u8c03\u7528\u4e00\u6b21 *\/\nQiniu_Client_InitNoAuth(&client, 1024); \/* HTTP\u5ba2\u6237\u7aef\u521d\u59cb\u5316\u3002HTTP\u5ba2\u6237\u7aef\u662f\u7ebf\u7a0b\u4e0d\u5b89\u5168\u7684\uff0c\u4e0d\u8981\u5728\u591a\u4e2a\u7ebf\u7a0b\u95f4\u5171\u7528 *\/\n\n...\n\nQiniu_Client_Cleanup(&client); \/* \u6bcf\u4e2aHTTP\u5ba2\u6237\u7aef\u4f7f\u7528\u5b8c\u540e\u91ca\u653e *\/\nQiniu_Global_Cleanup(); \/* \u5168\u5c40\u6e05\u7406\u51fd\u6570\uff0c\u53ea\u9700\u8981\u5728\u8fdb\u7a0b\u9000\u51fa\u65f6\u8c03\u7528\u4e00\u6b21 *\/\n```\n\n\u4e24\u8005\u4e3b\u8981\u7684\u533a\u522b\u5728\u4e8e\uff1a\n\n- \u5ba2\u6237\u7aef\u6ca1\u6709 QINIU_ACCESS_KEY\u3001QINIU_SECRET_KEY \u53d8\u91cf\uff08\u4e0d\u9700\u8981\u521d\u59cb\u5316\uff09\u3002\n- \u5ba2\u6237\u7aef\u6ca1\u6709\u7b7e\u540d\u6388\u6743\uff0c\u6240\u4ee5\u521d\u59cb\u5316 Qiniu_Client \u5bf9\u8c61\u5e94\u8be5\u7528 Qiniu_Client_InitNoAuth \u800c\u4e0d\u662f Qiniu_Client_InitMacAuth\u3002\n- \u5ba2\u6237\u7aef\u521d\u59cb\u5316\uff0f\u6e05\u7406\u7528 Qiniu_Global_Init\/Cleanup\uff0c\u800c\u670d\u52a1\u7aef\u7528 Qiniu_Servend_Init\/Cleanup \u8fd9\u5bf9\u51fd\u6570\u3002\n\n\n\n# \u5185\u5b58\u7ba1\u7406\n\n\u5728 C-SDK \u4e2d\uff0c\u6709\u4e00\u4e9b\u51fd\u6570\u4f1a\u6d89\u53ca\u5230\u5185\u5b58\u7684\u52a8\u6001\u5206\u914d\u3002\u8fd9\u4e9b\u51fd\u6570\u7684\u4e00\u60ef\u5904\u7406\u65b9\u5f0f\u662f\u5728\u51fd\u6570\u5185\u90e8\u7533\u8bf7\u5185\u5b58\uff0c\u5e76\u4ee5\u6307\u9488\u7684\u5f62\u5f0f\u76f4\u63a5\u8fd4\u56de\u3002\u8fd9\u5c31\u8981\u6c42\u51fd\u6570\u8c03\u7528\u8005\u5728\u5f97\u5230\u6307\u9488\u540e\uff0c\u9700\u8981\u5728\u6070\u5f53\u7684\u65f6\u673a\u53bb\u91ca\u653e\u8fd9\u4e9b\u5185\u5b58\u3002\u5bf9\u4e8e\u7279\u6b8a\u7684\u7ed3\u6784\u4f53\uff0cC-SDK \u90fd\u4f1a\u63d0\u4f9b\u7279\u5b9a\u7684\u51fd\u6570\u6765\u91ca\u653e\u5185\u5b58\uff0c\u4f8b\u5982 Qiniu_Buffer \u63d0\u4f9b\u4e86 Qiniu_Buffer_Cleanup \u51fd\u6570\u3002\u800c\u5bf9\u4e8e\u5176\u4ed6\u57fa\u672c\u6570\u636e\u7c7b\u578b\u7684\u6307\u9488\uff0c\u5219\u7531 Qiniu_Free \u51fd\u6570\u6765\u8d1f\u8d23\u91ca\u653e\u4e0d\u518d\u4f7f\u7528\u7684\u5185\u5b58\u3002\n\n\n\n## HTTP \u5ba2\u6237\u7aef\n\n\u5728 C-SDK \u4e2d\uff0cHTTP \u5ba2\u6237\u7aef\u53eb Qiniu_Client\u3002\u5728\u67d0\u4e9b\u8bed\u8a00\u73af\u5883\u4e2d\uff0c\u8fd9\u4e2a\u7c7b\u662f\u7ebf\u7a0b\u5b89\u5168\u7684\uff0c\u591a\u4e2a\u7ebf\u7a0b\u53ef\u4ee5\u5171\u4eab\u540c\u4e00\u4efd\u5b9e\u4f8b\uff0c\u4f46\u5728 C-SDK \u4e2d\u5b83\u88ab\u8bbe\u8ba1\u4e3a\u7ebf\u7a0b\u4e0d\u5b89\u5168\u7684\u3002\u4e00\u4e2a\u91cd\u8981\u7684\u539f\u56e0\u662f\u6211\u4eec\u8bd5\u56fe\u7b80\u5316\u5185\u5b58\u7ba1\u7406\u7684\u8d1f\u62c5\u3002HTTP \u8bf7\u6c42\u7ed3\u679c\u7684\u751f\u547d\u5468\u671f\u88ab\u8bbe\u8ba1\u6210\u7531 Qiniu_Client \u8d1f\u8d23\uff0c\u5728\u4e0b\u4e00\u6b21\u8bf7\u6c42\u65f6\u4f1a\u81ea\u52a8\u91ca\u653e\u4e0a\u4e00\u6b21 HTTP \u8bf7\u6c42\u7684\u7ed3\u679c\u3002\u5982\u679c\u67d0\u4e2a HTTP \u8bf7\u6c42\u7ed3\u679c\u7684\u6570\u636e\u9700\u8981\u957f\u671f\u4f7f\u7528\uff0c\u5efa\u8bae\u60a8\u590d\u5236\u4e00\u4efd\uff0c\u5982\uff1a\n\n```cpp\nvoid stat(Qiniu_Client* client, const char* bucket, const char* key) {\n Qiniu_RS_StatRet ret;\n Qiniu_Error err = Qiniu_RS_Stat(client, &ret, bucket, key);\n if (err.code != 200) {\n debug(client, err);\n return;\n }\n printf(\"hash: %s, fsize: %lld, mimeType: %s\\n\", ret.hash, ret.fsize, ret.mimeType);\n}\n```\n\n\u8fd9\u4e2a\u4f8b\u5b50\u4e2d\uff0cQiniu_RS_Stat \u8bf7\u6c42\u8fd4\u56de\u4e86 Qiniu_Error \u548c Qiniu_RS_StatRet \u4e24\u4e2a\u7ed3\u6784\u4f53\u3002\u5176\u4e2d\u7684 Qiniu_Error \u7c7b\u578b\u5982\u4e0b\uff1a\n\n```cpp\ntypedef struct _Qiniu_Error {\n int code;\n const char* message;\n} Qiniu_Error;\n```\n\nQiniu_RS_StatRet \u7c7b\u578b\u5982\u4e0b\uff1a\n\n```cpp\ntypedef struct _Qiniu_RS_StatRet {\n const char* hash;\n const char* mimeType;\n Qiniu_Int64 fsize;\n Qiniu_Int64 putTime;\n Qiniu_Int64 type;\n} Qiniu_RS_StatRet;\n```\n\n**\u6ce8\u610f\uff1a**Qiniu_Error.message\u3001Qiniu_RS_StatRet.hash\u3001Qiniu_RS_StatRet.mimeType \u90fd\u58f0\u660e\u4e3a const char* \u7c7b\u578b\uff0c\u662f\u4e2a\u53ea\u8bfb\u5b57\u7b26\u4e32\uff0c\u5e76\u4e0d\u7ba1\u7406\u5b57\u7b26\u4e32\u5185\u5bb9\u7684\u751f\u547d\u5468\u671f\u3002 \u8fd9\u4e9b\u5b57\u7b26\u4e32\u4ec0\u4e48\u65f6\u5019\u5931\u6548\uff1f\u4e0b\u6b21 Qiniu_Client \u53d1\u751f\u7f51\u7edc API \u8bf7\u6c42\u65f6\u5931\u6548\u3002\u5982\u679c\u60a8\u9700\u8981\u957f\u4e45\u4f7f\u7528\uff0c\u5efa\u8bae\u60a8\u590d\u5236\u4e00\u4efd\uff0c\u5982\uff1a\n\n```cpp\nhash = strdup(ret.hash);\n```\n\n\n\n## \u9519\u8bef\u5904\u7406\u4e0e\u8c03\u8bd5\n\n\u5728 HTTP \u8bf7\u6c42\u51fa\u9519\u7684\u65f6\u5019\uff0cC-SDK \u7edf\u4e00\u8fd4\u56de\u4e86\u4e00\u4e2a Qiniu_Error \u7ed3\u6784\u4f53\uff1a\n\n```cpp\ntypedef struct _Qiniu_Error {\n int code;\n const char* message;\n} Qiniu_Error;\n```\n\n\u5373\u4e00\u4e2a\u9519\u8bef\u7801\u548c\u5bf9\u5e94\u7684\u63cf\u8ff0\u6d88\u606f\u3002\u8fd9\u4e2a\u9519\u8bef\u7801\u6709\u53ef\u80fd\u662f cURL \u7684\u9519\u8bef\u7801\uff0c\u8868\u793a\u8bf7\u6c42\u53d1\u9001\u73af\u8282\u53d1\u751f\u4e86\u610f\u5916\uff0c\u6216\u8005\u662f\u4e00\u4e2a HTTP \u9519\u8bef\u7801\uff0c\u8868\u793a\u8bf7\u6c42\u53d1\u9001\u6b63\u5e38\uff0c\u670d\u52a1\u5668\u7aef\u5904\u7406\u8bf7\u6c42\u540e\u8fd4\u56de\u4e86 HTTP \u9519\u8bef\u7801\u3002\n\n\u5982\u679c\u4e00\u5207\u6b63\u5e38\uff0ccode \u5e94\u8be5\u662f 200\uff0c\u5373 HTTP \u7684 OK \u72b6\u6001\u7801\u3002\u5982\u679c\u4e0d\u662f 200\uff0c\u5219\u9700\u8981\u5bf9 code \u503c\u8fdb\u884c\u76f8\u5e94\u5206\u6790\u3002\u5bf9\u4e8e\u4f4e\u4e8e 200 \u7684\u503c\uff0c\u53ef\u4ee5\u67e5\u770b[cURL\u9519\u8bef\u7801](http:\/\/curl.haxx.se\/libcurl\/c\/libcurl-errors.html)\u3002\n\n\u5982\u679c message \u6307\u793a\u7684\u4fe1\u606f\u8fd8\u4e0d\u591f\u53cb\u597d\uff0c\u4e5f\u53ef\u4ee5\u5c1d\u8bd5\u628a\u6574\u4e2a HTTP \u8fd4\u56de\u5305\u6253\u5370\u51fa\u6765\u770b\u770b\uff1a\n\n```cpp\nvoid debug(Qiniu_Client* client, Qiniu_Error err)\n{\n printf(\"\\nerror code: %d, message: %s\\n\", err.code, err.message);\n printf(\"respose header:\\n%s\", Qiniu_Buffer_CStr(&client->respHeader));\n printf(\"respose body:\\n%s\", Qiniu_Buffer_CStr(&client->b));\n}\n```\n\n\n\n# \u6587\u4ef6\u4e0a\u4f20\n\n## \u4e0a\u4f20\u6d41\u7a0b\n\n\n\n\u5728\u79c1\u6709\u4e91\u5b58\u50a8\u4e2d\uff0c\u6574\u4e2a\u4e0a\u4f20\u6d41\u7a0b\u5927\u81f4\u5206\u4e3a\u4ee5\u4e0b\u51e0\u6b65\uff1a\n\n1. \u4e1a\u52a1\u670d\u52a1\u5668\u9881\u53d1\u4e0a\u4f20\u51ed\u8bc1\u7ed9\u5ba2\u6237\u7aef\uff08\u7ec8\u7aef\u7528\u6237\uff09\n2. \u5ba2\u6237\u7aef\u51ed\u501f\u4e0a\u4f20\u51ed\u8bc1\u4e0a\u4f20\u6587\u4ef6\u5230\u79c1\u6709\u4e91\u5b58\u50a8\n3. \u5728\u79c1\u6709\u4e91\u5b58\u50a8\u83b7\u5f97\u5b8c\u6574\u6570\u636e\u540e\uff0c\u53d1\u8d77\u4e00\u4e2a HTTP \u8bf7\u6c42\u56de\u8c03\u5230\u4e1a\u52a1\u670d\u52a1\u5668\n4. \u4e1a\u52a1\u670d\u52a1\u5668\u4fdd\u5b58\u76f8\u5173\u4fe1\u606f\uff0c\u5e76\u8fd4\u56de\u4e00\u4e9b\u4fe1\u606f\u7ed9\u79c1\u6709\u4e91\u5b58\u50a8\n5. \u79c1\u6709\u4e91\u5b58\u50a8\u539f\u5c01\u4e0d\u52a8\u5730\u5c06\u8fd9\u4e9b\u4fe1\u606f\u8f6c\u53d1\u7ed9\u5ba2\u6237\u7aef\uff08\u7ec8\u7aef\u7528\u6237\uff09\n\n**\u6ce8\u610f\uff1a**\u56de\u8c03\u5230\u4e1a\u52a1\u670d\u52a1\u5668\u7684\u8fc7\u7a0b\u662f\u53ef\u9009\u7684\uff0c\u5b83\u53d6\u51b3\u4e8e\u4e1a\u52a1\u670d\u52a1\u5668\u9881\u53d1\u7684\u4e0a\u4f20\u51ed\u8bc1\u3002\u5982\u679c\u6ca1\u6709\u56de\u8c03\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u4f1a\u8fd4\u56de\u4e00\u4e9b\u6807\u51c6\u7684\u4fe1\u606f\uff08\u4f8b\u5982\u6587\u4ef6\u7684 hash\uff09\u7ed9\u5ba2\u6237\u7aef\u3002 \u5982\u679c\u4e0a\u4f20\u53d1\u751f\u5728\u4e1a\u52a1\u670d\u52a1\u5668\uff0c\u4ee5\u4e0a\u6d41\u7a0b\u7b80\u5316\u4e3a\uff1a\n\n1. \u4e1a\u52a1\u670d\u52a1\u5668\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\n2. \u51ed\u501f\u4e0a\u4f20\u51ed\u8bc1\u4e0a\u4f20\u6587\u4ef6\u5230\u79c1\u6709\u4e91\u5b58\u50a8\n3. \u540e\u7eed\u5de5\u4f5c\uff0c\u4f8b\u5982\u4fdd\u5b58\u4e00\u4e9b\u76f8\u5173\u4fe1\u606f\n\n## \u4e0a\u4f20\u51ed\u8bc1\n\n\u4e0a\u4f20\u51ed\u8bc1\u5b9e\u9645\u4e0a\u662f\u7528 AccessKey\/SecretKey \u8fdb\u884c\u6570\u5b57\u7b7e\u540d\u7684\u4e0a\u4f20\u7b56\u7565 Qiniu_RS_PutPolicy\uff0c\u5b83\u63a7\u5236\u7740\u6574\u4e2a\u4e0a\u4f20\u6d41\u7a0b\u7684\u884c\u4e3a\u3002\u5177\u4f53\u4e0a\u4f20\u7b56\u7565\u53c2\u6570\u7684\u89e3\u91ca\u53ef\u89c1 [\u4e0a\u4f20\u51ed\u8bc1](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/manual\/1208\/upload-token.html)\n\n```cpp\ntypedef struct _Qiniu_RS_PutPolicy {\n const char *scope;\n const char *saveKey;\n Qiniu_Uint32 isPrefixalScope;\n const char *callbackUrl;\n const char *callbackHost;\n const char *callbackBody;\n const char *callbackBodyType;\n const char *callbackFetchKey;\n const char *returnUrl;\n const char *returnBody;\n const char *endUser;\n const char *persistentOps;\n const char *persistentNotifyUrl;\n const char *persistentPipeline;\n const char *mimeLimit;\n Qiniu_Uint64 fsizeLimit;\n Qiniu_Uint64 fsizeMin;\n Qiniu_Uint32 detectMime;\n Qiniu_Uint32 insertOnly;\n Qiniu_Uint32 expires;\n Qiniu_Uint32 deleteAfterDays;\n Qiniu_Uint32 fileType;\n} Qiniu_RS_PutPolicy;\n```\n\n\u5728\u6784\u5efa\u4e0a\u4f20\u51ed\u8bc1\u4e4b\u524d\uff0c\u6211\u4eec\u9996\u5148\u8981\u5b9a\u4e49\u9274\u6743\u5bf9\u8c61Qiniu_mac\n\n```cpp\nQiniu_Mac mac;\nmac.accessKey = \"your access key\";\nmac.secretKey = \"your secret key\";\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```cpp\n\/\/\u7b80\u5355\u4e0a\u4f20\u51ed\u8bc1\nchar *bucket=\"your bucket name\";\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nputPolicy.scope = bucket;\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"simple:\\t%s\\n\\n\", uptoken);\nQiniu_Free(uptoken);\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\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nputPolicy.scope = bucket;\nputPolicy.expires = 7200; \/\/\u5355\u4f4d\u79d2\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"returnBody:\\t%s\\n\\n\", uptoken);\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```cpp\n\/\/\u8986\u76d6\u4e0a\u4f20\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nchar *keyToOverwrite = \"qiniu.png\";\nputPolicy.scope = Qiniu_String_Concat3(bucket, \":\",keyToOverwrite);\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"overwrite:\\t%s\\n\\n\", uptoken);\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\u79c1\u6709\u4e91\u5b58\u50a8\u4e4b\u540e\uff0c\u5728\u6ca1\u6709\u8bbe\u7f6e`returnBody`\u6216\u8005`\u56de\u8c03`\u76f8\u5173\u7684\u53c2\u6570\u60c5\u51b5\u4e0b\uff0c\u79c1\u6709\u4e91\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```\n\/\/\u81ea\u5b9a\u4e49\u8fd4\u56de\u503c\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nputPolicy.scope = bucket;\nputPolicy.returnBody = \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"fsize\\\":$(fsize),\\\"bucket\\\":\\\"$(bucket)\\\",\\\"name\\\":\\\"$(x:name)\\\"}\";\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"returnBody:\\t%s\\n\\n\", uptoken);\n```\n\n\u5219\u6587\u4ef6\u4e0a\u4f20\u5230\u79c1\u6709\u4e91\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\u79c1\u6709\u4e91\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\u79c1\u6709\u4e91\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\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u4e0a\u4f20\u56de\u8c03\u53ca\u76f8\u5173\u56de\u8c03\u53c2\u6570\u7684\u8bbe\u7f6e\u3002\n\n```\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nputPolicy.scope = bucket;\nputPolicy.callbackUrl = \"http:\/\/api.example.com\/upload\/callback\";\nputPolicy.callbackBodyType = \"application\/json\";\nputPolicy.callbackBody = \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"fsize\\\":$(fsize),\\\"bucket\\\":\\\"$(bucket)\\\",\\\"name\\\":\\\"$(x:name)\\\"}\";\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"callback(json):\\t%s\\n\\n\", uptoken);\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\u79c1\u6709\u4e91\u5b58\u50a8\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```\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Zero(putPolicy);\nputPolicy.scope = bucket;\nputPolicy.callbackUrl = \"http:\/\/api.example.com\/upload\/callback\";\n\/\/putPolicy.callbackBodyType = \"application\/json\";\nputPolicy.callbackBody =\"key=$(key)&hash=$(etag)&bucket=$(bucket)&fsize=$(fsize)&name=$(x:name)\" ;\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\nprintf(\"callback(json):\\t%s\\n\\n\", uptoken);\n```\n\n\n\n### **\u5e26\u81ea\u5b9a\u4e49\u53c2\u6570\u7684\u51ed\u8bc1**\n\n\u5b58\u50a8\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\u79c1\u6709\u4e91\u5b58\u50a8\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```\nreturnBody: '{\"key\":\"$(key)\",\"hash\":\"$(etag)\",\"fsize\":$(fsize),\"bucket\":\"$(bucket)\",\"name\":\"$(x:name)\",\"age\":$(x:age)}'\n}\n```\n\n\u6216\u8005\n\n```\ncallbackBody: '{\"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<\/br> <\/br>\n\n## \u670d\u52a1\u7aef\u76f4\u4f20\n\n\u670d\u52a1\u7aef\u76f4\u4f20\u662f\u6307\u5ba2\u6237\u5229\u7528\u79c1\u6709\u4e91\u5b58\u50a8\u670d\u52a1\u7aefSDK\u4ece\u670d\u52a1\u7aef\u76f4\u63a5\u4e0a\u4f20\u6587\u4ef6\u5230\u79c1\u6709\u4e91\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\u79c1\u6709\u4e91\u5b58\u50a8\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\u6d41\u7a0b**\n\n\u5b58\u50a8\u652f\u6301\u7a7a\u95f4\u521b\u5efa\u5728\u4e0d\u540c\u7684\u673a\u623f\uff0c\u5e76\u4e14\u652f\u6301http\u548chttps\u4e0a\u4f20\u3002 \u5728\u4f7f\u7528\u79c1\u6709\u4e91\u5b58\u50a8\u7684 C-SDK \u4e2d\u7684`Qiniu_Use_Zone_xxx(Qiniu_False)`\u51fd\u6570\u53ef\u4ee5\u6307\u5b9a\u5bf9\u5e94\u7684\u4e0a\u4f20\u7a7a\u95f4\uff0c\u53c2\u6570`Qiniu_False`\u4ee3\u8868\u4e0d\u4f7f\u7528https\u65b9\u5f0f\u4e0a\u4f20\u3002\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```\nQiniu_Global_Init(-1);\n\nQiniu_Mac mac;\nmac.accessKey = \"your access key\";\nmac.secretKey = \"your secret key\";\n\nchar *bucket = \"your bucket name\";\nchar *key = \"qiniu.mp4\";\nchar *localFile = \"\/Users\/jemy\/Documents\/qiniu.mp4\";\n\nQiniu_Io_PutRet putRet;\nQiniu_Client client;\nQiniu_RS_PutPolicy putPolicy;\nQiniu_Io_PutExtra putExtra;\nQiniu_Zero(putPolicy);\nQiniu_Zero(putExtra);\n\nputPolicy.scope = bucket;\n\nchar *uptoken = Qiniu_RS_PutPolicy_Token(&putPolicy, &mac);\n\/\/\u8bbe\u7f6e\u673a\u623f\u57df\u540d\n\/\/Qiniu_Use_Zone_Beimei(Qiniu_False);\n\/\/Qiniu_Use_Zone_Huabei(Qiniu_True);\nQiniu_Use_Zone_Huadong(Qiniu_False);\n\/\/Qiniu_Use_Zone_Huanan(Qiniu_True);\n\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_Io_PutFile(&client, &putRet, uptoken, key, localFile, &putExtra);\nif (error.code != 200) {\n printf(\"upload file %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7statRet\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"upload file %s:%s success.\\n\\n\", bucket, key);\n printf(\"key:\\t%s\\n\",putRet.key);\n printf(\"hash:\\t%s\\n\", putRet.hash);\n}\nQiniu_Free(uptoken);\nQiniu_Client_Cleanup(&client);\n```\n\n\n\n### **\u6587\u4ef6\u5206\u7247\u4e0a\u4f20\uff08\u65ad\u70b9\u7eed\u4f20\uff09**\n\n\u9664\u4e86\u57fa\u672c\u7684\u4e0a\u4f20\u5916\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u8fd8\u652f\u6301\u5c06\u6587\u4ef6\u5207\u6210\u82e5\u5e72\u5757\u3002\u53ef\u4ee5\u9009\u62e9\u5206\u7247\u4e0a\u4f20\u7248\u672c\uff0c\u63a8\u8350 Qiniu_Multipart_PutFile\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v2 \u7248\uff0cQiniu_Rio_PutFile\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v1 \u7248\u3002 \u65ad\u70b9\u7eed\u4e0a\u4f20\u3001\u5206\u5757\u4e0a\u4f20\u7684\u57fa\u672c\u6837\u4f8b\uff1a\n\n\u5206\u7247\u4e0a\u4f20 v2 \u7248 \uff08v7.1.0\u4e4b\u4e0a\u7248\u672c\u652f\u6301\uff09\n\n```cpp\nint resumable_upload(Qiniu_Client* client, char* uptoken, const char* key, const char* localFile, Qiniu_MultipartUpload_Result* putRet) {\n Qiniu_Error err;\n Qiniu_Recorder recorder;\n err = Qiniu_FileSystem_Recorder_New(\"\/tmp\", &recorder);\n if (err.code != 200) {\n return err.code;\n }\n Qiniu_Multipart_PutExtra extra;\n Qiniu_Zero(extra);\n extra.recorder = &recorder; \/\/ \u652f\u6301\u65ad\u70b9\u7eed\u4f20\n extra.partSize = 4 << 20 \/\/ \u5206\u7247\u4e0a\u4f20 v2 \u652f\u6301\u81ea\u5b9a\u4e49\u5206\u7247\u5927\u5c0f\uff0c\u516c\u6709\u4e91\u7247\u7684\u5927\u5c0f\u8303\u56f4\u5728 1MB ~ 1GB \u3002 \n err = Qiniu_Multipart_PutFile(client, uptoken, key, localFile, &extra, putRet);\n recorder.free(&recorder);\n return err.code;\n}\n```\n\n\u76f8\u6bd4\u666e\u901a\u4e0a\u4f20\uff0c\u65ad\u70b9\u7eed\u4e0a\u4f20\u4ee3\u7801\u6ca1\u6709\u53d8\u590d\u6742\u3002\u57fa\u672c\u4e0a\u5c31\u53ea\u662f\u5c06 Qiniu_Io_PutExtra \u6539\u4e3a Qiniu_Multipart_PutExtra\uff0cQiniu_Io_PutFile \u6539\u4e3a Qiniu_Multipart_PutFile\u3002\n\n\u5b9e\u9645\u4e0a Qiniu_Multipart_PutFile \u591a\u4e86\u4e0d\u5c11\u914d\u7f6e\u9879\uff0c\u5176\u4e2d\u6700\u91cd\u8981\u7684\u662f\uff1arecorder\uff0c\u5b83\u88ab\u7528\u6765\u8bbe\u7f6e\u65ad\u70b9\u7684\u5b58\u50a8\u65b9\u5f0f\uff0c\u4f8b\u5982\u53ef\u4ee5\u7528 Qiniu_FileSystem_Recorder_New \u6765\u521b\u5efa\u57fa\u4e8e\u6587\u4ef6\u7cfb\u7edf\u7684\u65ad\u70b9\u5b58\u50a8\uff0c\u4f60\u4e5f\u53ef\u4ee5\u57fa\u4e8e Qiniu_Recorder \u5bf9\u8c61\u5b9a\u4e49\u81ea\u5df1\u7684\u65ad\u70b9\u5b58\u50a8\u65b9\u5f0f\u3002\n\n\u5206\u7247\u4e0a\u4f20 v1 \u7248\n\n```cpp\nint resumable_upload(Qiniu_Client* client, char* uptoken, const char* key, const char* localFile) {\n Qiniu_Error err;\n Qiniu_Recorder recorder;\n err = Qiniu_FileSystem_Recorder_New(\"\/tmp\", &recorder);\n if (err.code != 200) {\n return err.code;\n }\n Qiniu_Rio_PutExtra extra;\n Qiniu_Zero(extra);\n extra.bucket = bucket;\n extra.recorder = &recorder; \/\/ \u652f\u6301\u65ad\u70b9\u7eed\u4f20\n err = Qiniu_Rio_PutFile(client, NULL, uptoken, key, localFile, &extra);\n recorder.free(&recorder);\n return err.code;\n}\n```\n\n\n\n### **\u89e3\u6790\u81ea\u5b9a\u4e49\u56de\u590d\u5185\u5bb9**\n\n\u6709\u4e9b\u60c5\u51b5\u4e0b\uff0c\u79c1\u6709\u4e91\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\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\u79c1\u6709\u4e91\u5b58\u50a8\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\u6216\u8005\u81ea\u5b9a\u4e49\u53d8\u91cf\uff0c\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**\u6ce8\u610f**\uff1a\u4e1a\u52a1\u7aef\u670d\u52a1\u5668\u56de\u8c03\u9274\u6743\u7684Content-Type\u7c7b\u578b\u5e94\u8be5\u4e0e\u4e0a\u4f20\u7b56\u7565\u4e2d\u6307\u5b9a\u7684callbackBodyType\u76f8\u540c\uff0c\u9ed8\u8ba4\u4e3a application\/x-www-form-urlencoded\uff0c\u5f53 Content-Type \u4e3a application\/x-www-form-urlencoded \u65f6\uff0c\u7b7e\u540d\u5185\u5bb9\u5fc5\u987b\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9\u3002\u5f53 Content-Type \u4e3a application\/json \u65f6\uff0c\u7b7e\u540d\u5185\u5bb9\u4e0d\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9\u3002\n\n\u4e1a\u52a1\u670d\u52a1\u5668\u5728\u6536\u5230\u6765\u81ea\u79c1\u6709\u4e91\u5b58\u50a8\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\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u672a\u7ecf\u7be1\u6539\u7684\u8bf7\u6c42,\u5177\u4f53\u53ef\u4ee5\u53c2\u8003\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u56de\u8c03\u9274\u6743\u3002\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## \u516c\u5f00\u7a7a\u95f4\n\n\u6bcf\u4e2a bucket \u90fd\u4f1a\u7ed1\u5b9a\u4e00\u4e2a\u6216\u591a\u4e2a\u57df\u540d (domain)\u3002\u5982\u679c\u8fd9\u4e2a bucket \u662f\u516c\u5f00\u7684\uff0c\u90a3\u4e48\u8be5 bucket \u4e2d\u7684\u6240\u6709\u6587\u4ef6\u53ef\u4ee5\u901a\u8fc7\u4e00\u4e2a\u516c\u5f00\u7684\u4e0b\u8f7d url \u8bbf\u95ee\uff1a\n\n```\nhttp:\/\/domain\/key\n```\n\n\u5176\u4e2d `domain` \u662f bucket \u5bf9\u5e94\u7684\u57df\u540d\u3002\u79c1\u6709\u4e91\u5b58\u50a8\u4e3a\u6bcf\u4e00\u4e2a bucket \u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u57df\u540d\u3002\u9ed8\u8ba4\u57df\u540d\u53ef\u4ee5\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e2d\u7684\u5b58\u50a8\u7a7a\u95f4\u67e5\u8be2\u3002\n\n\u5047\u8bbe\u67d0\u4e2a bucket \u65e2\u7ed1\u5b9a\u4e86\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u4e8c\u7ea7\u57df\u540d\uff0c\u5982\uff1ahello.qiniudn.com\uff0c\u4e5f\u7ed1\u5b9a\u4e86\u81ea\u5b9a\u4e49\u57df\u540d\uff08\u9700\u8981\u5907\u6848\uff09\uff0c\u5982\uff1ahello.com\u3002\u90a3\u4e48\u8be5 bucket \u4e2d key \u4e3a test.mp4 \u7684\u6587\u4ef6\u53ef\u4ee5\u901a\u8fc7 `http:\/\/hello.qiniudn.com\/qiniu.mp4` \u6216 `http:\/\/hello.com\/qiniu.mp4` \u4e2d\u4efb\u610f\u4e00\u4e2a url \u8fdb\u884c\u8bbf\u95ee\u3002\n\n\n\n## \u79c1\u6709\u7a7a\u95f4\n\n\u5982\u679c\u67d0\u4e2a bucket \u662f\u79c1\u6709\u7684\uff0c\u90a3\u4e48\u8fd9\u4e2a bucket \u4e2d\u7684\u6240\u6709\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7\u4e00\u4e2a\u4e34\u65f6\u6709\u6548\u7684 downloadUrl \u8bbf\u95ee\uff1a\n\n```\nhttp:\/\/domain\/key?e=<deadline>&token=<dntoken>\n```\n\n\u5176\u4e2d `dntoken` \u662f\u7531\u4e1a\u52a1\u670d\u52a1\u5668\u7b7e\u53d1\u7684\u4e00\u4e2a\u4e34\u65f6\u4e0b\u8f7d\u51ed\u8bc1\uff0c`deadline` \u662f\u5176\u6709\u6548\u671f\u3002\u4e0b\u8f7d\u51ed\u8bc1\u4e0d\u9700\u8981\u5355\u72ec\u751f\u6210\uff0cC-SDK \u63d0\u4f9b\u4e86\u751f\u6210\u5b8c\u6574 downloadUrl \u7684\u65b9\u6cd5\uff08\u5305\u542b\u4e86 dntoken\uff09\uff0c\u793a\u4f8b\u4ee3\u7801\u5982\u4e0b\uff1a\n\n```cpp\nchar* downloadUrl(const char* domain, const char* key, Qiniu_Mac* mac) {\n\n char* url = 0;\n char* baseUrl = 0;\n\n Qiniu_RS_GetPolicy getPolicy;\n Qiniu_Zero(getPolicy);\n\n baseUrl = Qiniu_RS_MakeBaseUrl(domain, key);\n url = Qiniu_RS_GetPolicy_MakeRequest(&getPolicy, baseUrl, mac);\n Qiniu_Free(baseUrl);\n return url;\n}\n```\n\n\u751f\u6210 downloadUrl \u540e\uff0c\u670d\u52a1\u7aef\u4e0b\u53d1 downloadUrl \u7ed9\u5ba2\u6237\u7aef\u3002\u5ba2\u6237\u7aef\u6536\u5230 downloadUrl \u540e\uff0c\u548c\u516c\u6709\u8d44\u6e90\u7c7b\u4f3c\uff0c\u76f4\u63a5\u7528\u4efb\u610f\u7684 HTTP \u5ba2\u6237\u7aef\u5c31\u53ef\u4ee5\u4e0b\u8f7d\u8be5\u8d44\u6e90\u4e86\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5728 downloadUrl \u5931\u6548\u5374\u8fd8\u6ca1\u6709\u5b8c\u6210\u4e0b\u8f7d\u65f6\uff0c\u9700\u8981\u91cd\u65b0\u5411\u670d\u52a1\u5668\u7533\u8bf7\u6388\u6743\u3002\n\n# \u8d44\u6e90\u7ba1\u7406\n\n\u8d44\u6e90\u7ba1\u7406\u5305\u62ec\u7684\u4e3b\u8981\u529f\u80fd\u6709\uff1a \u8d44\u6e90\u7ba1\u7406\u5305\u62ec\u5bf9\u5b58\u50a8\u5728\u79c1\u6709\u4e91\u5b58\u50a8\u4e0a\u7684\u6587\u4ef6\u8fdb\u884c\u67e5\u770b\u3001\u5220\u9664\u3001\u590d\u5236\u548c\u79fb\u52a8\u5904\u7406\u3002\u540c\u65f6\u79c1\u6709\u4e91\u5b58\u50a8\u4e5f\u652f\u6301\u5bf9\u6587\u4ef6\u8fdb\u884c\u76f8\u5e94\u7684\u6279\u91cf\u64cd\u4f5c\u3002\u6240\u6709\u64cd\u4f5c\u90fd\u4f1a\u8fd4\u56de\u4e00\u4e2a Qiniu_Error \u7684\u7ed3\u6784\u4f53\uff0c\u7528\u4e8e\u8bb0\u5f55\u672c\u6b21\u64cd\u4f5c\u7684\u6210\u529f\uff0f\u5931\u8d25\u4fe1\u606f\u3002\n\n## \u83b7\u53d6\u6587\u4ef6\u4fe1\u606f\n\n\u901a\u8fc7\u8c03\u7528 Qiniu_RS_Stat\uff0c\u53ef\u4ee5\u5f97\u5230\u6307\u5b9a\u6587\u4ef6\u7684\u5c5e\u6027\u4fe1\u606f\u3002\u9664\u4e86\u4f1a\u8fd4\u56de\u4e00\u4e2a Qiniu_Error \u7ed3\u6784\u4f53\u5916\uff0cQiniu_RS_Stat \u8fd8\u4f1a\u8fd4\u56de Qiniu_RS_StatRet \u7ed3\u6784\u4f53\uff0c\u5176\u4e2d\u8bb0\u5f55\u4e86\u88ab\u67e5\u8be2\u6587\u4ef6\u7684\u4e00\u4e9b\u5c5e\u6027\u4fe1\u606f\u3002\n\n```cpp\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Stat(&client, &statRet, bucket, key);\nif (error.code != 200) {\n printf(\"stat file %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7statRet\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"stat file \\t%s:%s success.\\n\\n\", bucket, key);\n printf(\"file hash: \\t%s\\n\", statRet.hash);\n printf(\"file size: \\t%lld\\n\", statRet.fsize);\n printf(\"file put time: \\t%lld\\n\", statRet.putTime);\n printf(\"file mime type: \\t%s\\n\", statRet.mimeType);\n printf(\"file type: \\t%lld\\n\", statRet.type);\n}\n```\n\n\n\n## \u4fee\u6539\u6587\u4ef6MimeType\n\n```\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nchar *newMime=\"video\/x-mp4\";\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_ChangeMime(&client, bucket, key, newMime);\nif (error.code != 200) {\n printf(\"change file mime %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n printf(\"change file mime %s:%s success.\\n\\n\", bucket, key);\n}\n```\n\n\n\n## \u4fee\u6539\u6587\u4ef6\u5b58\u50a8\u7c7b\u578b\n\n```\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\n\/\/fileType=0\u8868\u793a\u666e\u901a\u5b58\u50a8\uff0cfileType\u4e3a1\u8868\u793a\u4f4e\u9891\u5b58\u50a8\nint fileType=1;\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_ChangeType(&client, bucket, key, fileType);\nif (error.code != 200) {\n printf(\"change file type %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n printf(\"change file type %s:%s success.\\n\\n\", bucket, key);\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```\nchar *srcbucket=\"if-pbl\";\nchar *srcKey = \"qiniu.png\";\nchar *destBucket = srcBucket;\nchar *destKey = \"qiniu_move.png\";\nQiniu_Bool force = Qiniu_True;\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Move(&client, srcBucket, srcKey, destBucket, destKey, force);\nif (error.code != 200) {\n printf(\"move file %s:%s -> %s:%s error.\\n\", srcBucket, srcKey, destBucket, destKey);\n debug_log(&client, error);\n} else {\n printf(\"move file %s:%s -> %s:%s success.\\n\", srcBucket, srcKey, destBucket, destKey);\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```\nchar *srcBucket=\"if-pbl\";\nchar *srcKey = \"qiniu.png\";\nchar *destBucket = srcBucket;\nchar *destKey = \"qiniu_copy.png\";\nQiniu_Bool force = Qiniu_True;\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Copy(&client, srcBucket, srcKey, destBucket, destKey, force);\nif (error.code != 200) {\n printf(\"copy file %s:%s -> %s:%s error.\\n\", srcBucket, srcKey, destBucket, destKey);\n debug_log(&client, error);\n} else {\n printf(\"copy file %s:%s -> %s:%s success.\\n\", srcBucket, srcKey, destBucket, destKey);\n}\n```\n\n\n\n## \u5220\u9664\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\n\n```\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Delete(&client, bucket, key);\nif (error.code != 200) {\n printf(\"delete file %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n printf(\"delete file %s:%s file success.\\n\", bucket, key);\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```\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nint days=7;\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_DeleteAfterDays(&client, bucket, key, days);\nif (error.code != 200) {\n printf(\"deleteAfterDays file %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n printf(\"deleteAfterDays file %s:%s file success.\\n\", bucket, key);\n}\n```\n\n\n\n## \u83b7\u53d6\u6307\u5b9a\u7a7a\u95f4\u7684\u6587\u4ef6\u5217\u8868\n\n```\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\nchar *bucket=\"if-pbl\";\nchar **commonPrefixes = NULL;\nQiniu_RSF_ListItem *items = NULL;\nchar *prefix = \"\";\nchar *delimiter = \"\/\";\nchar *marker = \"\";\nchar *nextMarker = marker;\nQiniu_Bool isNewMarker = Qiniu_False;\nint limit = 10;\nint i;\n\ndo {\n \/\/init\n Qiniu_Client_InitMacAuth(&client, 1024, &mac);\n Qiniu_Error error = Qiniu_RSF_ListFiles(&client, &listRet, bucket, prefix, delimiter, nextMarker, limit);\n\n if (error.code != 200) {\n printf(\"list files of bucket %s error.\\n\", bucket);\n debug_log(&client, error);\n nextMarker = \"\";\n }\n else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7listRet\u53d8\u91cf\u67e5\u8be2\u6587\u4ef6\u5217\u8868\u4fe1\u606f*\/\n printf(\"list files of bucket %s success.\\n\\n\", bucket);\n\n \/\/check next marker\n if (isNewMarker == Qiniu_True) {\n free(nextMarker);\n }\n\n if (!str_empty(listRet.marker)) {\n nextMarker = strdup(listRet.marker);\n isNewMarker = Qiniu_True;\n }\n else {\n nextMarker = NULL;\n }\n printf(\"next marker: %s\\n\", nextMarker);\n\n \/\/common prefixes\n commonPrefixes = listRet.commonPrefixes;\n for (i = 0; i < listRet.commonPrefixesCount; i++) {\n printf(\"commonPrefix: %s\\n\", *commonPrefixes);\n ++commonPrefixes;\n }\n\n \/\/items\n items = listRet.items;\n for (i = 0; i < listRet.itemsCount; i++) {\n Qiniu_RSF_ListItem item = listRet.items[i];\n printf(\"key: %s, hash: %s, fsize: %lld, mime: %s, putTime: %lld, endUser: %s, type: %lld\\n\",\n item.key, item.hash, item.fsize, item.mimeType, item.putTime, item.endUser, item.type);\n }\n\n \/\/free\n if (listRet.commonPrefixes != NULL) {\n Qiniu_Free(listRet.commonPrefixes);\n }\n if (listRet.items != NULL) {\n Qiniu_Free(listRet.items);\n }\n\n Qiniu_Zero(listRet);\n }\n\n Qiniu_Client_Cleanup(&client);\n} while (!str_empty(nextMarker));\n```\n\n\n\n## \u6293\u53d6\u7f51\u7edc\u8d44\u6e90\u5230\u7a7a\u95f4\n\n```\n\/\/fetch with key\nQiniu_RS_FetchRet fetchRet;\nchar *bucket=\"if-pbl\";\nchar *resURL = \"http:\/\/devtools.qiniu.com\/qiniu.png\";\nchar *key = \"qiniu.png\";\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Fetch(&client, &fetchRet, resURL, bucket, key);\nif (error.code != 200) {\n printf(\"fetch file %s -> %s:%s error.\\n\", resURL, bucket, key);\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7fetchRet\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"fetch file %s -> %s:%s success.\\n\", resURL, bucket, key);\n printf(\"file key: \\t%s\\n\", fetchRet.key);\n printf(\"file hash: \\t%s\\n\", fetchRet.hash);\n printf(\"file size: \\t%lld\\n\", fetchRet.fsize);\n printf(\"file mime type: \\t%s\\n\", fetchRet.mimeType);\n}\n```\n\n\n\n## \u66f4\u65b0\u955c\u50cf\u7a7a\u95f4\u4e2d\u5b58\u50a8\u7684\u6587\u4ef6\u5185\u5bb9\n\n```\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_Prefetch(&client, bucket, key);\nif (error.code != 200) {\n printf(\"prefetch file %s:%s error.\\n\", bucket, key);\n debug_log(&client, error);\n} else {\n printf(\"prefetch file \\t%s:%s success.\\n\\n\", bucket, key);\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```\nQiniu_RS_BatchStatRet *statRets;\nint i;\nchar *bucket=\"if-pbl\";\nchar *key=\"qiniu.mp4\";\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryPath *entries = (Qiniu_RS_EntryPath *) malloc(sizeof(Qiniu_RS_EntryPath) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n Qiniu_RS_EntryPath entry;\n entry.bucket = bucket;\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n entry.key = Qiniu_String_Concat2(key, indexStr);\n Qiniu_Free(indexStr);\n entries[i] = entry;\n}\n\nstatRets = (Qiniu_RS_BatchStatRet *) malloc(sizeof(Qiniu_RS_BatchStatRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchStat(&client, statRets, entries, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch stat file error.\\n\");\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7statRets\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"batch stat file success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n Qiniu_RS_StatRet data = statRets[i].data;\n int code = statRets[i].code;\n if (code == 200) {\n printf(\"file hash: \\t%s\\n\", data.hash);\n printf(\"file size: \\t%lld\\n\", data.fsize);\n printf(\"file put time: \\t%lld\\n\", data.putTime);\n printf(\"file mime type: \\t%s\\n\", data.mimeType);\n printf(\"file type: \\t%lld\\n\", data.type);\n } else {\n printf(\"error: %s\\n\", statRets[i].error);\n }\n }\n}\n```\n\n\u5176\u4e2d\uff0centries \u662f\u4e00\u4e2a\u6307\u5411 Qiniu_RS_EntryPath \u7ed3\u6784\u4f53\u6570\u7ec4\u7684\u6307\u9488\uff0centryCount \u4e3a\u6570\u7ec4 entries \u7684\u957f\u5ea6\u3002\u7ed3\u6784\u4f53 Qiniu_RS_EntryPath \u4e2d\u586b\u5199\u6bcf\u4e2a\u6587\u4ef6\u76f8\u5e94\u7684 bucket \u548c key\uff1a\n\n```cpp\ntypedef struct _Qiniu_RS_EntryPath {\n const char* bucket;\n const char* key;\n} Qiniu_RS_EntryPath;\n```\n\nQiniu_RS_BatchStat \u4f1a\u5c06\u6587\u4ef6\u4fe1\u606f\uff08\u53ca\u6210\u529f\uff0f\u5931\u8d25\u4fe1\u606f\uff09\u4f9d\u6b21\u5199\u5165\u4e00\u4e2a\u7531\u7ed3\u6784\u4f53 Qiniu_RS_BatchStatRet \u7ec4\u6210\u7684\u6570\u7ec4\u7a7a\u95f4 rets\u3002\u56e0\u6b64\uff0c\u8c03\u7528\u4e4b\u524d\uff0c\u9700\u8981\u5148\u7ed9 rets \u7533\u8bf7\u597d\u76f8\u5e94\u957f\u5ea6\u7684\u5185\u5b58\u7a7a\u95f4\u3002\n\n\u5176\u4e2d\u7ed3\u6784\u4f53 Qiniu_RS_BatchStatRet \u7684\u7ec4\u6210\u5982\u4e0b\uff1a\n\n```cpp\ntypedef struct _Qiniu_RS_BatchStatRet {\n Qiniu_RS_StatRet data;\n const char* error;\n int code;\n}Qiniu_RS_BatchStatRet;\n```\n\n\n\n### **\u6279\u91cf\u4fee\u6539\u6587\u4ef6\u7c7b\u578b**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\nchar *key=\"qiniu.mp4\";\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryChangeMime *entries = (Qiniu_RS_EntryChangeMime *) malloc(\n sizeof(Qiniu_RS_EntryChangeMime) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n Qiniu_RS_EntryChangeMime entry;\n entry.bucket = bucket;\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n entry.key = Qiniu_String_Concat2(key, indexStr);\n Qiniu_Free(indexStr);\n entry.mime = \"image\/x-png\";\n entries[i] = entry;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchChangeMime(&client, itemRets, entries, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch change file mime error.\\n\");\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7itemRets\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"batch change file mime success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```\n\n\n\n### **\u6279\u91cf\u5220\u9664\u6587\u4ef6**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\nchar *key = \"qiniu.png\";\nchar *bucket=\"if-pbl\";\n\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryPath *entries = (Qiniu_RS_EntryPath *) malloc(sizeof(Qiniu_RS_EntryPath) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n Qiniu_RS_EntryPath entry;\n entry.bucket = bucket;\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n entry.key = Qiniu_String_Concat2(key, indexStr);\n entries[i] = entry;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchDelete(&client, itemRets, entries, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch delete file error.\\n\");\n debug_log(&client, error);\n} else {\n printf(\"batch delete file success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```\n\n\n\n### **\u6279\u91cf\u590d\u5236\u6587\u4ef6**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\n\nchar *key = \"qiniu.png\";\nchar *bucket=\"if-pbl\";\n\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryPathPair *entryPairs = (Qiniu_RS_EntryPathPair *) malloc(sizeof(Qiniu_RS_EntryPathPair) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n \/\/src\n Qiniu_RS_EntryPath srcEntry;\n srcEntry.bucket = bucket;\n srcEntry.key = key;\n\n \/\/dest\n Qiniu_RS_EntryPath destEntry;\n destEntry.bucket = bucket;\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n destEntry.key = Qiniu_String_Concat2(key, indexStr);\n Qiniu_Free(indexStr);\n\n \/\/pack\n Qiniu_RS_EntryPathPair entryPair;\n entryPair.src = srcEntry;\n entryPair.dest = destEntry;\n entryPair.force = Qiniu_True;\n entryPairs[i] = entryPair;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchCopy(&client, itemRets, entryPairs, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch copy file error.\\n\");\n debug_log(&client, error);\n} else {\n printf(\"batch copy file success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```\n\n\n\n### **\u6279\u91cf\u79fb\u52a8\u6216\u91cd\u547d\u540d\u6587\u4ef6**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\n\nchar *bucket=\"if-pbl\";\nchar *key = \"qiniu.png\";\n\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryPathPair *entryPairs = (Qiniu_RS_EntryPathPair *) malloc(sizeof(Qiniu_RS_EntryPathPair) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n\n \/\/src\n Qiniu_RS_EntryPath srcEntry;\n srcEntry.bucket = bucket;\n srcEntry.key = Qiniu_String_Concat2(key, indexStr);\n\n \/\/dest\n Qiniu_RS_EntryPath destEntry;\n destEntry.bucket = bucket;\n destEntry.key = Qiniu_String_Concat3(key, indexStr, \"-move\");\n\n Qiniu_Free(indexStr);\n\n \/\/pack\n Qiniu_RS_EntryPathPair entryPair;\n entryPair.src = srcEntry;\n entryPair.dest = destEntry;\n entryPair.force = Qiniu_True;\n entryPairs[i] = entryPair;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchMove(&client, itemRets, entryPairs, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch move file error.\\n\");\n debug_log(&client, error);\n} else {\n printf(\"batch move file success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```\n\n\n\n### **\u6279\u91cf\u66f4\u65b0\u6587\u4ef6\u7684\u6709\u6548\u671f**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\n\nchar *bucket=\"if-pbl\";\nchar *key = \"qiniu.png\";\n\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryDeleteAfterDays *entries = (Qiniu_RS_EntryDeleteAfterDays *) malloc(\n sizeof(Qiniu_RS_EntryDeleteAfterDays) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n Qiniu_RS_EntryDeleteAfterDays entry;\n entry.bucket = bucket;\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n entry.key = Qiniu_String_Concat2(key, indexStr);\n Qiniu_Free(indexStr);\n entry.days = 7;\/\/\u8bbe\u7f6e7\u5929\u6709\u6548\u671f\n entries[i] = entry;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchDeleteAfterDays(&client, itemRets, entries, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch deleteAfterDays file error.\\n\");\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7itemRets\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"batch deleteAfterDays file success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```\n\n\n\n### **\u6279\u91cf\u66f4\u65b0\u6587\u4ef6\u5b58\u50a8\u7c7b\u578b**\n\n```\nQiniu_RS_BatchItemRet *itemRets;\nQiniu_Client client;\nint i;\nchar *key = \"qiniu.png\";\nchar *bucket=\"if-pbl\";\n\nQiniu_ItemCount entryCount = 10;\nQiniu_RS_EntryChangeType *entries = (Qiniu_RS_EntryChangeType *) malloc(\n sizeof(Qiniu_RS_EntryChangeType) * entryCount);\nfor (i = 0; i < entryCount; i++) {\n Qiniu_RS_EntryChangeType entry;\n entry.bucket = bucket;\n\n size_t indexLen = snprintf(NULL, 0, \"%d\", i) + 1;\n char *indexStr = (char *) calloc(sizeof(char), indexLen);\n snprintf(indexStr, indexLen, \"%d\", i);\n entry.key = Qiniu_String_Concat2(key, indexStr);\n Qiniu_Free(indexStr);\n entry.fileType = 1;\/\/\u6539\u4e3a\u4f4e\u9891\u5b58\u50a8\n entries[i] = entry;\n}\n\nitemRets = (Qiniu_RS_BatchItemRet *) malloc(sizeof(Qiniu_RS_BatchItemRet) * entryCount);\n\n\/\/init\nQiniu_Client_InitMacAuth(&client, 1024, &mac);\nQiniu_Error error = Qiniu_RS_BatchChangeType(&client, itemRets, entries, entryCount);\nif (error.code \/ 100 != 2) {\n printf(\"batch change file type error.\\n\");\n debug_log(&client, error);\n} else {\n \/*200, \u6b63\u786e\u8fd4\u56de\u4e86, \u4f60\u53ef\u4ee5\u901a\u8fc7itemRets\u53d8\u91cf\u67e5\u8be2\u4e00\u4e9b\u5173\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u7684\u4fe1\u606f*\/\n printf(\"batch change file type success.\\n\\n\");\n\n for (i = 0; i < entryCount; i++) {\n int code = itemRets[i].code;\n if (code == 200) {\n printf(\"success: %d\\n\", code);\n } else {\n printf(\"code: %d, error: %s\\n\", code, itemRets[i].error);\n }\n }\n}\n```"}