!3552 add api 9

Merge pull request !3552 from zhangxingxia/OpenHarmony-3.1-Release

!3552 add api 9
Merge pull request !3552 from zhangxingxia/OpenHarmony-3.1-Release
c5fe408b · openharmony_ci · Gitee · 80b1f23c · de69d3f5 · c5fe408b
4 changed file
--- a/zh-cn/application-dev/reference/apis/Readme-CN.md
+++ b/zh-cn/application-dev/reference/apis/Readme-CN.md
@@ -92,6 +92,7 @@
  - [@ohos.fileManager (公共文件访问与管理)](js-apis-filemanager.md)
  - [@ohos.statfs (statfs)](js-apis-statfs.md)
  - [@ohos.storageStatistics (应用空间统计)](js-apis-storage-statistics.md)
+  - [@ohos.volumeManager (卷管理)](js-apis-volumemanager.md)
 - 电话服务

  - [@ohos.contact (联系人)](js-apis-contact.md)

--- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md
@@ -625,7 +625,7 @@ read(fd: number, buffer: ArrayBuffer, options?: {
  | ------- | ----------- | ---- | ---------------------------------------- |
  | fd      | number      | 是    | 待读取文件的文件描述符。                             |
  | buffer  | ArrayBuffer | 是    | 用于保存读取到的文件数据的缓冲区。                        |
-  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型                                 | 说明     |
@@ -662,7 +662,7 @@ read(fd: number, buffer: ArrayBuffer, options: {
  | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
  | fd       | number                                   | 是    | 待读取文件的文件描述符。                             |
  | buffer   | ArrayBuffer                              | 是    | 用于保存读取到的文件数据的缓冲区。                        |
-  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |
  | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是    | 异步读取数据之后的回调。                             |

 - 示例：
@@ -695,7 +695,7 @@ readSync(fd: number, buffer: ArrayBuffer, options?: {
  | ------- | ----------- | ---- | ---------------------------------------- |
  | fd      | number      | 是    | 待读取文件的文件描述符。                             |
  | buffer  | ArrayBuffer | 是    | 用于保存读取到的文件数据的缓冲区。                        |
-  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型     | 说明       |
@@ -867,7 +867,7 @@ write(fd: number, buffer: ArrayBuffer | string, options?: {
  | ------- | ------------------------------- | ---- | ---------------------------------------- |
  | fd      | number                          | 是    | 待写入文件的文件描述符。                             |
  | buffer  | ArrayBuffer&nbsp;\|&nbsp;string | 是    | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 |

 - 返回值：
  | 类型                    | 说明       |
@@ -903,7 +903,7 @@ write(fd: number, buffer: ArrayBuffer | string, options: {
  | -------- | ------------------------------- | ---- | ---------------------------------------- |
  | fd       | number                          | 是    | 待写入文件的文件描述符。                             |
  | buffer   | ArrayBuffer&nbsp;\|&nbsp;string | 是    | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options  | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options  | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 |
  | callback | AsyncCallback&lt;number&gt;     | 是    | 异步将数据写入完成后执行的回调函数。                       |

 - 示例：
@@ -935,7 +935,7 @@ writeSync(fd: number, buffer: ArrayBuffer | string, options?: {
  | ------- | ------------------------------- | ---- | ---------------------------------------- |
  | fd      | number                          | 是    | 待写入文件的文件描述符。                             |
  | buffer  | ArrayBuffer&nbsp;\|&nbsp;string | 是    | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 |

 - 返回值：
  | 类型     | 说明       |
@@ -1473,9 +1473,9 @@ read(buffer: ArrayBuffer, options?: {

 - 参数：
  | 参数名  | 类型        | 必填 | 说明                                                         |
-  | ------- | ----------- | ---- | ---------------------------------------- |
+  | ------- | ----------- | ---- | ------------------------------------------------------------ |
  | buffer  | ArrayBuffer | 是   | 用于保存读取到的文件数据的缓冲区。                           |
-  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。 |
+  | options | Object      | 否   | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;约束:offset+length<=buffer.size。 |

 - 返回值：
  | 类型                                 | 说明     |
@@ -1509,7 +1509,7 @@ read(buffer: ArrayBuffer, options: {
  | 参数名      | 类型                                       | 必填   | 说明                                       |
  | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
  | buffer   | ArrayBuffer                              | 是    | 用于保存读取到的文件数据的缓冲区。                        |
-  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。 |
+  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;约束:offset+length<=buffer.size。 |
  | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是    | 异步从文件读取数据之后的回调。                          |

 - 示例
@@ -2721,7 +2721,7 @@ write(buffer: ArrayBuffer | string, options?: {
  | 参数名     | 类型                              | 必填   | 说明                                       |
  | ------- | ------------------------------- | ---- | ---------------------------------------- |
  | buffer  | ArrayBuffer&nbsp;\|&nbsp;string | 是    | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型                    | 说明       |
@@ -2754,9 +2754,9 @@ write(buffer: ArrayBuffer | string, options: {

 - 参数：
  | 参数名   | 类型                            | 必填 | 说明                                                         |
-  | -------- | ------------------------------- | ---- | ---------------------------------------- |
+  | -------- | ------------------------------- | ---- | ------------------------------------------------------------ |
  | buffer   | ArrayBuffer&nbsp;\|&nbsp;string | 是   | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options  | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options  | Object                          | 否   | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 |
  | callback | AsyncCallback&lt;number&gt;     | 是   | 异步写入完成后执行的回调函数。                               |

 - 示例：
@@ -2788,7 +2788,7 @@ writeSync(buffer: ArrayBuffer | string, options?: {
  | 参数名     | 类型                              | 必填   | 说明                                       |
  | ------- | ------------------------------- | ---- | ---------------------------------------- |
  | buffer  | ArrayBuffer&nbsp;\|&nbsp;string | 是    | 待写入文件的数据，可来自缓冲区或字符串。                     |
-  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。 |
+  | options | Object                          | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型     | 说明       |
@@ -2818,7 +2818,7 @@ read(buffer: ArrayBuffer, options?: {
  | 参数名     | 类型          | 必填   | 说明                                       |
  | ------- | ----------- | ---- | ---------------------------------------- |
  | buffer  | ArrayBuffer | 是    | 用于读取文件的缓冲区。                              |
-  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型                                 | 说明     |
@@ -2853,7 +2853,7 @@ read(buffer: ArrayBuffer, options: {
  | 参数名      | 类型                                       | 必填   | 说明                                       |
  | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
  | buffer   | ArrayBuffer                              | 是    | 用于读取文件的缓冲区。                              |
-  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options  | Object                                   | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |
  | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是    | 异步从流文件读取数据之后的回调。                         |

 - 示例：
@@ -2884,7 +2884,7 @@ readSync(buffer: ArrayBuffer, options?: {
  | 参数名     | 类型          | 必填   | 说明                                       |
  | ------- | ----------- | ---- | ---------------------------------------- |
  | buffer  | ArrayBuffer | 是    | 用于读取文件的缓冲区。                              |
-  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。 |
+  | options | Object      | 否    | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。  |

 - 返回值：
  | 类型     | 说明       |

--- a/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md
@@ -3,7 +3,7 @@
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 >
 > - 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-> - 本模块接口为系统接口，三方应用不支持调用。
+> - API 9当前为Canary版本，仅供试用，不保证接口可稳定调用。

 ## 导入模块

@@ -68,6 +68,7 @@ getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):v
  ```
  
  
+
 ## storagestatistics.getFreeSizeOfVolume

 getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
@@ -124,3 +125,71 @@ getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):vo
      console.info("getFreeSizeOfVolume successfully:"+ number);
  });
  ```
+
+## storagestatistics.getBundleStats<sup>9+</sup>
+
+getBundleStats(packageName: string): Promise&lt;BundleStats&gt;
+
+异步获取应用存储数据，以promise方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+- 参数
+
+  | 参数名      | 类型   | 必填 | 说明     |
+  | ----------- | ------ | ---- | -------- |
+  | packageName | string | 是   | 应用包名 |
+  
+- 返回值
+
+  | 类型                                       | 说明                       |
+  | ------------------------------------------ | -------------------------- |
+  | Promise&lt;[Bundlestats](#bundlestats)&gt; | 返回指定卷上的应用存储状态 |
+
+- 示例
+
+  ```js
+  let packageName = "";
+  storagestatistics.getBundleStats(packageName).then(function(BundleStats){
+      console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
+  }).catch(function(err){
+      console.info("getBundleStats failed with error:"+ err);
+  });
+  ```
+
+## storagestatistics.getBundleStats<sup>9+</sup>
+
+getBundleStats(packageName: string,  callback: AsyncCallback&lt;BundleStats&gt;): void
+
+异步获取应用存储数据，以callback方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+- 参数
+
+  | 参数名   | 类型                                                      | 必填 | 说明                                 |
+  | -------- | --------------------------------------------------------- | ---- | ------------------------------------ |
+  | packageName | string | 是   | 应用包名 |
+  | callback | callback:AsyncCallback&lt;[Bundlestats](#bundlestats)&gt; | 是   | 获取指定卷上的应用存储状态之后的回调 |
+  
+- 示例
+
+  ```js
+  let packageName = "";
+  storagestatistics.getBundleStats(packageName, function(error, BundleStats){
+      // do something
+      console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
+  });
+  ```
+
+## BundleStats<sup>9+</sup>
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.SpatialStatistics。
+
+### 属性
+
+| 名称      | 类型   | 说明           |
+| --------- | ------ | -------------- |
+| appSize<sup>9+</sup>   | number | app数据大小    |
+| cacheSize<sup>9+</sup> | number | 缓存数据大小   |
+| dataSize<sup>9+</sup>  | number | 应用总数据大小 |
\ No newline at end of file
--- a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md
+# 卷管理
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+>
+> - 本模块首批接口从API version 9开始支持。
+> - API 9当前为Canary版本，仅供试用，不保证接口可稳定调用。
+
+## 导入模块
+
+```js
+import volumemanager from "@ohos.volumeManager";
+```
+
+## volumemanager.getAllVolumes
+
+getAllVolumes(): Promise&lt;Array&lt;Volume&gt;&gt;
+
+异步获取当前所有可获得的卷信息，以promise方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 返回值
+
+  | 类型                               | 说明                       |
+  | ---------------------------------- | -------------------------- |
+  | Promise&lt;[Volume](#volume)[]&gt; | 返回当前所有可获得的卷信息 |
+
+- 示例
+
+  ```js
+  volumemanager.getAllVolumes().then(function(volumes){
+      // do something
+  });
+  ```
+
+## volumemanager.getAllVolumes
+
+getAllVolumes(callback: AsyncCallback&lt;Array&lt;Volume&gt;&gt;): void
+
+异步获取当前所有可获得的卷信息，以callback方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 参数
+
+  | 参数名   | 类型                                              | 必填 | 说明                                 |
+  | -------- | ------------------------------------------------- | ---- | ------------------------------------ |
+  | callback | callback:AsyncCallback&lt;[Volume](#volume)[]&gt; | 是   | 获取当前所有可获得的卷信息之后的回调 |
+  
+- 示例
+
+  ```js
+  let uuid = "";
+  volumemanager.getAllVolumes(uuid, function(error, volumes){
+      // do something
+  });
+  ```
+
+
+## volumemanager.mount
+
+mount(volumeId: string): Promise&lt;boolean&gt;
+
+异步挂载指定卷，以promise方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 参数
+
+  | 参数名   | 类型   | 必填 | 说明 |
+  | -------- | ------ | ---- | ---- |
+  | volumeId | string | 是   | 卷id |
+
+- 返回值
+
+  | 类型                   | 说明       |
+  | ---------------------- | ---------- |
+  | Promise&lt;boolean&gt; | 挂载指定卷 |
+
+- 示例
+
+  ```js
+  let volumeId = "";
+  volumemanager.mount(volumeId).then(function(flag){
+      // do something
+  });
+  ```
+
+## volumemanager.mount
+
+mount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
+
+异步获取指定卷的可用空间大小，以callback方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 参数
+
+  | 参数名   | 类型                                  | 必填 | 说明                 |
+  | -------- | ------------------------------------- | ---- | -------------------- |
+  | volumeId | string                                | 是   | 卷id                 |
+  | callback | callback:AsyncCallback&lt;boolean&gt; | 是   | 挂载指定卷之后的回调 |
+
+- 示例
+
+  ```js
+  let volumeId = "";
+  volumemanager.mount(volumeId, function(error, flag){
+      // do something
+  });
+  ```
+
+## volumemanager.unmount
+
+unmount(volumeId: string): Promise&lt;boolean&gt;
+
+异步卸载指定卷，以promise方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 参数
+
+  | 参数名   | 类型   | 必填 | 说明 |
+  | -------- | ------ | ---- | ---- |
+  | volumeId | string | 是   | 卷id |
+
+- 返回值
+
+  | 类型                   | 说明       |
+  | ---------------------- | ---------- |
+  | Promise&lt;boolean&gt; | 卸载指定卷 |
+
+- 示例
+
+  ```js
+  let volumeId = "";
+  volumemanager.unmount(volumeId).then(function(flag){
+      // do something
+  });
+  ```
+
+## volumemanager.unmount
+
+unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
+
+异步卸载指定卷，以callback方式返回。
+
+**系统能力**：SystemCapability.FileManagement.StorageService.Volume
+
+- 参数
+
+  | 参数名   | 类型                                  | 必填 | 说明                 |
+  | -------- | ------------------------------------- | ---- | -------------------- |
+  | volumeId | string                                | 是   | 卷id                 |
+  | callback | callback:AsyncCallback&lt;boolean&gt; | 是   | 卸载指定卷之后的回调 |
+
+- 示例
+
+  ```js
+  let volumeId = "";
+  volumemanager.unmount(volumeId, function(error, flag){
+      // do something
+  });
+  ```
+
+## Volume
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.Volume。
+
+### 属性
+
+| 名称        | 类型    | 说明                 |
+| ----------- | ------- | -------------------- |
+| id          | number  | 卷id                 |
+| uuid        | string  | 卷uuid               |
+| description | string  | 卷相关描述           |
+| removable | boolean | 是否为可移动存储设备 |
+| state       | int     | 当前卷状态           |
+| path        | string  | 卷的挂载地址         |
\ No newline at end of file