|
2 | 2 | ufile官方的node sdk实现比较悲惨……
|
3 | 3 |
|
4 | 4 | 接口参数和返回参考<https://docs.ucloud.cn/api/ufile-api/index>
|
5 |
| - |
6 |
| -<a name="UFile"></a> |
7 |
| - |
8 |
| -## UFile |
9 |
| -**Kind**: global class |
10 |
| - |
11 |
| -* [UFile](#UFile) |
12 |
| - * [new UFile(pubKey, priKey, bucketName, domain, useHttps)](#new_UFile_new) |
13 |
| - * [.prefixFileList([prefix], [marker], [limit])](#UFile+prefixFileList) ⇒ <code>Promise</code> |
14 |
| - * [.putFile(key, file, [mimeType])](#UFile+putFile) ⇒ <code>Promise</code> |
15 |
| - * [.uploadHit(hash, fileName, fileSize)](#UFile+uploadHit) ⇒ <code>Promise</code> |
16 |
| - * [.getFile(key, [range], [ifModifiedSince])](#UFile+getFile) ⇒ <code>Promise</code> |
17 |
| - * [.headFile(key)](#UFile+headFile) ⇒ <code>Promise</code> |
18 |
| - * [.deleteFile(key)](#UFile+deleteFile) ⇒ <code>Promise</code> |
19 |
| - * [.initiateMultipartUpload(key)](#UFile+initiateMultipartUpload) ⇒ <code>Promise</code> |
20 |
| - * [.uploadPart(key, uploadId, partNumber, buffer)](#UFile+uploadPart) ⇒ <code>Promise</code> |
21 |
| - * [.finishMultipartUpload(key, uploadId, [newKey], parts)](#UFile+finishMultipartUpload) ⇒ <code>Promise</code> |
22 |
| - * [.abortMultipartUpload(key, uploadId)](#UFile+abortMultipartUpload) ⇒ <code>Promise</code> |
23 |
| - * [.getMultiUploadId([prefix], [marker], [limit])](#UFile+getMultiUploadId) ⇒ <code>Promise</code> |
24 |
| - * [.getMultiUploadPart(uploadId)](#UFile+getMultiUploadPart) ⇒ <code>Promise</code> |
25 |
| - * [.opMeta(key, mimeType)](#UFile+opMeta) ⇒ <code>Promise</code> |
26 |
| - |
27 |
| -<a name="new_UFile_new"></a> |
28 |
| - |
29 |
| -### new UFile(pubKey, priKey, bucketName, domain, useHttps) |
30 |
| -UFile SDK |
31 |
| - |
32 |
| - |
33 |
| -| Param | Type | Default | Description | |
34 |
| -| --- | --- | --- | --- | |
35 |
| -| pubKey | <code>string</code> | | api公钥 | |
36 |
| -| priKey | <code>string</code> | | api私钥 | |
37 |
| -| bucketName | <code>string</code> | | 存储空间名 | |
38 |
| -| domain | <code>string</code> | | 存储空间域名 | |
39 |
| -| useHttps | <code>boolean</code> | <code>false</code> | 是否使用https | |
40 |
| - |
41 |
| -<a name="UFile+prefixFileList"></a> |
42 |
| - |
43 |
| -### uFile.prefixFileList([prefix], [marker], [limit]) ⇒ <code>Promise</code> |
44 |
| -前缀列表查询 |
45 |
| - |
46 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
47 |
| - |
48 |
| -| Param | Type | Default | Description | |
49 |
| -| --- | --- | --- | --- | |
50 |
| -| [prefix] | <code>string</code> | <code>"''"</code> | 前缀,utf-8编码,默认为空字符串 | |
51 |
| -| [marker] | <code>string</code> | <code>"''"</code> | 标志字符串,utf-8编码,默认为空字符串 | |
52 |
| -| [limit] | <code>number</code> | <code>20</code> | 文件列表数目,默认为20 | |
53 |
| - |
54 |
| -<a name="UFile+putFile"></a> |
55 |
| - |
56 |
| -### uFile.putFile(key, file, [mimeType]) ⇒ <code>Promise</code> |
57 |
| -上传文件 |
58 |
| - |
59 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
60 |
| - |
61 |
| -| Param | Type | Default | Description | |
62 |
| -| --- | --- | --- | --- | |
63 |
| -| key | <code>string</code> | | | |
64 |
| -| file | <code>Buffer</code> \| <code>Stream.Readable</code> \| <code>string</code> | | 文件 | |
65 |
| -| [mimeType] | <code>string</code> | <code>"'application/octet-stream'"</code> | 文件类型 | |
66 |
| - |
67 |
| -<a name="UFile+uploadHit"></a> |
68 |
| - |
69 |
| -### uFile.uploadHit(hash, fileName, fileSize) ⇒ <code>Promise</code> |
70 |
| -秒传文件 |
71 |
| - |
72 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
73 |
| - |
74 |
| -| Param | Type | Description | |
75 |
| -| --- | --- | --- | |
76 |
| -| hash | <code>string</code> | 待上传文件的ETag,详见ETag生成文档 | |
77 |
| -| fileName | <code>string</code> | Bucket中文件的名称 | |
78 |
| -| fileSize | <code>string</code> | 待上传文件的大小 | |
79 |
| - |
80 |
| -<a name="UFile+getFile"></a> |
81 |
| - |
82 |
| -### uFile.getFile(key, [range], [ifModifiedSince]) ⇒ <code>Promise</code> |
83 |
| -下载文件 |
84 |
| - |
85 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
86 |
| - |
87 |
| -| Param | Type | Description | |
88 |
| -| --- | --- | --- | |
89 |
| -| key | <code>string</code> | key | |
90 |
| -| [range] | <code>string</code> | 分片下载的文件范围 | |
91 |
| -| [ifModifiedSince] | <code>string</code> | 只返回从某时修改过的文件,否则返回304(not modified) | |
92 |
| - |
93 |
| -<a name="UFile+headFile"></a> |
94 |
| - |
95 |
| -### uFile.headFile(key) ⇒ <code>Promise</code> |
96 |
| -查询文件基本信息 |
97 |
| - |
98 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
99 |
| - |
100 |
| -| Param | Type | |
101 |
| -| --- | --- | |
102 |
| -| key | <code>string</code> | |
103 |
| - |
104 |
| -<a name="UFile+deleteFile"></a> |
105 |
| - |
106 |
| -### uFile.deleteFile(key) ⇒ <code>Promise</code> |
107 |
| -删除文件 |
108 |
| - |
109 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
110 |
| - |
111 |
| -| Param | Type | |
112 |
| -| --- | --- | |
113 |
| -| key | <code>string</code> | |
114 |
| - |
115 |
| -<a name="UFile+initiateMultipartUpload"></a> |
116 |
| - |
117 |
| -### uFile.initiateMultipartUpload(key) ⇒ <code>Promise</code> |
118 |
| -初始化分片上传 |
119 |
| - |
120 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
121 |
| - |
122 |
| -| Param | Type | Description | |
123 |
| -| --- | --- | --- | |
124 |
| -| key | <code>string</code> | 文件名 | |
125 |
| - |
126 |
| -<a name="UFile+uploadPart"></a> |
127 |
| - |
128 |
| -### uFile.uploadPart(key, uploadId, partNumber, buffer) ⇒ <code>Promise</code> |
129 |
| -上传分片 |
130 |
| - |
131 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
132 |
| - |
133 |
| -| Param | Type | Description | |
134 |
| -| --- | --- | --- | |
135 |
| -| key | <code>string</code> | 文件名 | |
136 |
| -| uploadId | <code>string</code> | 分片id | |
137 |
| -| partNumber | <code>number</code> | 第几块分片 | |
138 |
| -| buffer | <code>buffer</code> | 内容 | |
139 |
| - |
140 |
| -<a name="UFile+finishMultipartUpload"></a> |
141 |
| - |
142 |
| -### uFile.finishMultipartUpload(key, uploadId, [newKey], parts) ⇒ <code>Promise</code> |
143 |
| -完成分片 |
144 |
| - |
145 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
146 |
| - |
147 |
| -| Param | Type | Description | |
148 |
| -| --- | --- | --- | |
149 |
| -| key | <code>string</code> | 文件名 | |
150 |
| -| uploadId | <code>string</code> | 分片id | |
151 |
| -| [newKey] | <code>string</code> | 等上传完毕开始指定的key可能已经被占用,遇到这种情形时会采用newKey参数的值作为文件最终的key,否则仍然采用原来的key | |
152 |
| -| parts | <code>array</code> | 分片的etag们 | |
153 |
| - |
154 |
| -<a name="UFile+abortMultipartUpload"></a> |
155 |
| - |
156 |
| -### uFile.abortMultipartUpload(key, uploadId) ⇒ <code>Promise</code> |
157 |
| -放弃分片 |
158 |
| - |
159 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
160 |
| - |
161 |
| -| Param | Type | Description | |
162 |
| -| --- | --- | --- | |
163 |
| -| key | <code>string</code> | 文件名 | |
164 |
| -| uploadId | <code>string</code> | 分片id | |
165 |
| - |
166 |
| -<a name="UFile+getMultiUploadId"></a> |
167 |
| - |
168 |
| -### uFile.getMultiUploadId([prefix], [marker], [limit]) ⇒ <code>Promise</code> |
169 |
| -获取正在执行的分片上传 |
170 |
| - |
171 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
172 |
| - |
173 |
| -| Param | Type | Default | Description | |
174 |
| -| --- | --- | --- | --- | |
175 |
| -| [prefix] | <code>string</code> | | 前缀,utf-8编码,默认为空字符串 | |
176 |
| -| [marker] | <code>string</code> | | 标志字符串,utf-8编码,默认为空字符串 | |
177 |
| -| [limit] | <code>number</code> | <code>20</code> | id列表数目,默认为20 | |
178 |
| - |
179 |
| -<a name="UFile+getMultiUploadPart"></a> |
180 |
| - |
181 |
| -### uFile.getMultiUploadPart(uploadId) ⇒ <code>Promise</code> |
182 |
| -获取已上传成功的分片列表 |
183 |
| - |
184 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
185 |
| - |
186 |
| -| Param | Type | Description | |
187 |
| -| --- | --- | --- | |
188 |
| -| uploadId | <code>string</code> | 上传id | |
189 |
| - |
190 |
| -<a name="UFile+opMeta"></a> |
191 |
| - |
192 |
| -### uFile.opMeta(key, mimeType) ⇒ <code>Promise</code> |
193 |
| -操作文件的Meta信息 |
194 |
| - |
195 |
| -**Kind**: instance method of [<code>UFile</code>](#UFile) |
196 |
| - |
197 |
| -| Param | Type | Description | |
198 |
| -| --- | --- | --- | |
199 |
| -| key | <code>string</code> | key | |
200 |
| -| mimeType | <code>string</code> | 文件的mimetype | |
201 |
| - |
0 commit comments