!6717 [翻译完成】#I5G22U

Merge pull request !6717 from Annie_wang/PR6503

en/application-dev/reference/apis/js-apis-filemanager.md

 # User File Access and Management
+
+The fileManager module provides APIs for accessing and managing user files. It interworks with the underlying file management services to implement media library and external card management, and provides capabilities for applications to query and create user files.
+
 >**NOTE**<br/>
 >
 >- The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 >- The APIs of this module are system APIs and cannot be called by third-party applications. Currently, these APIs can be called only by **filepicker**.
 
-Provides service APIs for accessing and managing user files. It interworks with the underlying file management services to implement media library and external card management, and provides capabilities for applications to query and create user files.
-
 ## Modules to Import
 
 ```js

en/application-dev/reference/apis/js-apis-securityLabel.md

 # Security Label
 
+The secuityLabel module provides APIs to manage file data security levels, including obtaining and setting file data security levels.
+
 > **NOTE**<br/>
 > The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
-Manages file data security levels, including obtaining and setting file data security levels.
-
 ## Modules to Import
 
 ```js

en/application-dev/reference/apis/js-apis-statfs.md

 # statfs
 
-> **NOTE:**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+The statfs module provides APIs for obtaining file system information, including the total number of bytes and the number of idle bytes of the file system.
 
-This module provides information related to the file system. It provides JS APIs to obtain the total number of bytes and the number of idle bytes of the file system.
+> **NOTE**<br>
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 ## Modules to Import
 
 ```js
 import statfs from '@ohos.statfs';
 ```
-
-## Guidelines
-
-Before using the APIs provided by this module to perform operations on a file or directory, obtain the path of the application sandbox. For details, see [getOrCreateLocalDir of the Context module](js-apis-Context.md).
-
-Application sandbox path of a file or directory = Application directory + File name or directory name
-
-For example, if the application directory obtained by using **getOrCreateLocalDir** is **dir** and the file name is **xxx.txt**, the application sandbox path of the file is as follows:
-
-```js
-let path = dir + "xxx.txt";
-```
-
 ## statfs.getFreeBytes
 
 getFreeBytes(path:string):Promise&lt;number&gt;
@@ -72,8 +59,12 @@ Obtains the number of free bytes of the specified file system in asynchronous mo
 - Example
 
   ```js
-  statfs.getFreeBytes(path, function(err, number){
-      console.info("getFreeBytes callback successfully:"+ number);
+   import featureAbility from '@ohos.ability.featureAbility';
+  let context = featureAbility.getContext();
+  context.getFilesDir().then(function (path) {
+      statfs.getFreeBytes(path, function(err, number){
+          console.info("Got free bytes successfully:"+ number);
+      });
   });
   ```
 
@@ -126,7 +117,11 @@ Obtains the total number of bytes of the specified file system in asynchronous m
 - Example
 
   ```js
-  statfs.getTotalBytes(path, function(err, number){
-      console.info("getTotalBytes callback successfully:"+ number);
+  import featureAbility from '@ohos.ability.featureAbility';
+  let context = featureAbility.getContext();
+  context.getFilesDir().then(function (path) {
+      statfs.getTotalBytes(path, function(err, number){
+          console.info("Got total bytes successfully:"+ number);
+      });
   });
   ```

en/application-dev/reference/apis/js-apis-storage-statistics.md

 # App Storage Statistics
 
+The storageStatistics module provides APIs for obtaining storage space information, including the space of built-in and plug-in memory cards, space occupied by different types of data, and space of application data.
+
 > **NOTE**<br/>
 >
 > - The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 > - API version 9 is a canary version for trial use. The APIs of this version may be unstable.
 
-Obtains storage space information, including the space of built-in and plug-in memory cards, space occupied by different types of data, and space of application data.
-
 ## Modules to Import
 
 ```js

en/application-dev/reference/apis/js-apis-volumemanager.md

 # Volume Management
 
+The volumeManager module provides APIs for volume and disk management, including obtaining volume information, mounting or unmounting volumes, partitioning disks, and formatting volumes.
+
 > **NOTE**<br>
 >
 > - The initial APIs of this module are supported since API version 9.
 > - API version 9 is a canary version for trial use. The APIs of this version may be unstable.
 > - The APIs of this module are system APIs and cannot be called by third-party applications.
 
-The APIs of this module can be used to perform volume and disk management, including obtaining volume information, mounting and unmounting volumes, partitioning disks, and formatting volumes.
-
 ## Modules to Import
 
 ```js
@@ -20,19 +20,21 @@ getAllVolumes(): Promise&lt;Array&lt;Volume&gt;&gt;
 
 Asynchronously obtains information about all available volumes. This API uses a promise to return the result.
 
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Return value
+**Return value**
 
   | Type                              | Description                      |
   | ---------------------------------- | -------------------------- |
   | Promise&lt;[Volume](#volume)[]&gt; | Promise used to return the execution result.|
 
-- Example
+**Example**
 
   ```js
   volumemanager.getAllVolumes().then(function(volumes){
-      // do something
+      // Do something.
   });
   ```
 
@@ -42,20 +44,22 @@ getAllVolumes(callback: AsyncCallback&lt;Array&lt;Volume&gt;&gt;): void
 
 Asynchronously obtains information about all available volumes. This API uses a callback to return the result.
 
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Parameters
+**Parameters**
 
   | Name  | Type                                             | Mandatory| Description                                |
   | -------- | ------------------------------------------------- | ---- | ------------------------------------ |
   | callback | callback:AsyncCallback&lt;[Volume](#volume)[]&gt; | Yes  | Callback invoked to return the volume information obtained.|
-  
-- Example
+
+**Example**
 
   ```js
   let uuid = "";
-  volumemanager.getAllVolumes(uuid, function(error, volumes){
-      // do something
+  volumemanager.getAllVolumes(function(error, volumes){
+      // Do something
   });
   ```
 
@@ -66,26 +70,28 @@ mount(volumeId: string): Promise&lt;boolean&gt;
 
 Asynchronously mounts a volume. This API uses a promise to return the result.
 
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Parameters
+**Parameters**
 
   | Name  | Type  | Mandatory| Description|
   | -------- | ------ | ---- | ---- |
   | volumeId | string | Yes  | Volume ID.|
 
-- Return value
+**Return value**
 
   | Type                  | Description      |
   | ---------------------- | ---------- |
   | Promise&lt;boolean&gt; | Promise used to return the execution result.|
 
-- Example
+**Example**
 
   ```js
   let volumeId = "";
   volumemanager.mount(volumeId).then(function(flag){
-      // do something
+      // Do something
   });
   ```
 
@@ -95,21 +101,23 @@ mount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
 
 Asynchronously obtains the available space of the specified volume. This API uses a callback to return the result.
 
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Parameters
+**Parameters**
 
   | Name  | Type                                 | Mandatory| Description                |
   | -------- | ------------------------------------- | ---- | -------------------- |
   | volumeId | string                                | Yes  | Volume ID.                |
   | callback | callback:AsyncCallback&lt;boolean&gt; | Yes  | Callback invoked to return the execution result.|
 
-- Example
+**Example**
 
   ```js
   let volumeId = "";
   volumemanager.mount(volumeId, function(error, flag){
-      // do something
+      // Do something
   });
   ```
 
@@ -119,26 +127,28 @@ unmount(volumeId: string): Promise&lt;boolean&gt;
 
 Asynchronously unmounts a volume. This API uses a promise to return the result.
 
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Parameters
+**Parameters**
 
   | Name  | Type  | Mandatory| Description|
   | -------- | ------ | ---- | ---- |
   | volumeId | string | Yes  | Volume ID.|
 
-- Return value
+**Return value**
 
   | Type                  | Description      |
   | ---------------------- | ---------- |
   | Promise&lt;boolean&gt; | Promise used to return the execution result.|
 
-- Example
+**Example**
 
   ```js
   let volumeId = "";
   volumemanager.unmount(volumeId).then(function(flag){
-      // do something
+      // Do something
   });
   ```
 
@@ -148,21 +158,306 @@ unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
 
 Asynchronously unmounts a volume. This API uses a callback to return the result.
 
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.Volume
 
-- Parameters
+**Parameters**
 
   | Name  | Type                                 | Mandatory| Description                |
   | -------- | ------------------------------------- | ---- | -------------------- |
   | volumeId | string                                | Yes  | Volume ID.                |
   | callback | callback:AsyncCallback&lt;boolean&gt; | Yes  | Callback invoked to return the execution result.|
 
-- Example
+**Example**
 
   ```js
   let volumeId = "";
   volumemanager.unmount(volumeId, function(error, flag){
-      // do something
+      // Do something
+  });
+  ```
+
+## volumemanager.getVolumeByUuid
+
+getVolumeByUuid(uuid: string): Promise&lt;Volume&gt;
+
+Asynchronously obtains volume information based on the universally unique identifier (UUID). This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name  | Type  | Mandatory| Description|
+    | -------- | ------ | ---- | ---- |
+  | uuid | string | Yes  | UUID of the volume.|
+
+**Return value**
+
+  | Type                              | Description                      |
+    | ---------------------------------- | -------------------------- |
+  | Promise&lt;[Volume](#volume)&gt; | Promise used to return the volume information obtained.|
+
+**Example**
+
+  ```js
+  let uuid = "";
+  let volume = await volumemanager.getVolumeByUuid(uuid);
+  ```
+
+## volumemanager.getVolumeByUuid
+
+getVolumeByUuid(uuid: string, callback: AsyncCallback&lt;Volume&gt;): void
+
+Asynchronously obtains volume information based on the UUID. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name   | Type                                                | Mandatory| Description                |
+  | -------- | ------------------------------------------------ | ---- | -------------------- |
+  | uuid | string                                                 | Yes  | UUID of the volume.                |
+  | callback | callback:AsyncCallback&lt;[Volume](#volume)&gt;  | Yes  | Callback invoked to return the volume information obtained.|
+
+**Example**
+
+  ```js
+  let uuid = "";
+  volumemanager.getVolumeByUuid(uuid, (error, volume) => {
+      // Do something.   
+  });
+  ```
+
+## volumemanager.getVolumeById
+
+getVolumeById(id: string): Promise&lt;Volume&gt;
+
+Asynchronously obtains volume information based on the volume ID. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name   | Type   | Mandatory | Description|
+  | -------- | ------ | ---- | ---- |
+  | id | string | Yes  | Volume ID.|
+
+**Return value**
+
+  | Type                              | Description                      |
+  | ---------------------------------- | -------------------------- |
+  | Promise&lt;[Volume](#volume)&gt; | Promise used to return the volume information obtained.|
+
+**Example**
+
+  ```js
+  let id = "";
+  let volume = await volumemanager.getVolumeById(id);
+  ```
+
+## volumemanager.getVolumeById
+
+getVolumeById(id: string, callback: AsyncCallback&lt;Volume&gt;): void
+
+Asynchronously obtains volume information based on the volume ID. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name   | Type                                                | Mandatory| Description                |
+    | -------- | ------------------------------------------------ | ---- | -------------------- |
+  | id | string                                              | Yes  | Volume ID.                |
+  | callback | callback:AsyncCallback&lt;[Volume](#volume)&gt;  | Yes  | Callback invoked to return the volume information obtained.|
+
+**Example**
+
+  ```js
+  let id = "";
+  volumemanager.getVolumeById(id, (error, volume) => {
+      // Do something.   
+  });
+  ```
+
+## volumemanager.setVolumeDescription
+
+setVolumeDescription(uuid: string, description: string): Promise&lt;void&gt;
+
+Asynchronously sets the volume description based on the UUID. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name    | Type  | Mandatory| Description|
+  | --------- | ------ | ---- | ---- |
+  | uuid      | string | Yes  | UUID of the volume.|
+  | description | string | Yes  | Volume description.|
+
+**Return value**
+
+  | Type                   | Description                      |
+  | ---------------------- | -------------------------- |
+  | Promise&lt;void&gt; | Promise used to return the result.                 |
+
+**Example**
+
+  ```js
+  let uuid = "";
+  let description = "";
+  let bool = await volumemanager.setVolumeDescription(uuid, description);
+  ```
+
+## volumemanager.setVolumeDescription
+
+setVolumeDescription(uuid: string, description: string, callback: AsyncCallback&lt;void&gt;): void
+
+Asynchronously sets the volume description based on the UUID. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_UNMOUNT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name     | Type                                    | Mandatory| Description             |
+  | ---------- | --------------------------------------- | ---- | ---------------- |
+  | uuid       | string                                  | Yes  | UUID of the volume.           |
+  | description | string                                 | Yes  | Volume description.           |
+  | callback   | callback:AsyncCallback&lt;void&gt;   | Yes  | Callback invoked to return the result.|
+
+**Example**
+
+  ```js
+  let uuid = "";
+  let description = "";
+  volumemanager.setVolumeDescription(uuid, description, (error, bool) => {
+      // Do something.   
+  });
+  ```
+
+## volumemanager.format
+
+format(volId: string): Promise&lt;void&gt;
+
+Asynchronously formats a volume. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_FORMAT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name      | Type  | Mandatory| Description|
+  | ----------- | ------ | ---- | ---- |
+  | volId    | string | Yes  | Volume ID.|
+
+**Return value**
+
+  | Type                   | Description                      |
+    | --------------------- | ----------------------- |
+  | Promise&lt;void&gt; | Promise used to return the result.           |
+
+**Example**
+
+  ```js
+  let volId = "";
+  let bool = await volumemanager.format(volId);
+  ```
+
+## volumemanager.format
+
+format(volId: string, callback: AsyncCallback&lt;void&gt;): void
+
+Asynchronously formats a volume. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_FORMAT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name     | Type                                    | Mandatory| Description             |
+    | -------- | --------------------------------------- | ---- | ---------------- |
+  | volId   | string                                  | Yes  | Volume ID.           |
+  | callback   | callback:AsyncCallback&lt;void&gt;   | Yes  | Callback invoked to return the result. |
+
+**Example**
+
+  ```js
+  let volId = "";
+  volumemanager.format(volId, (error, bool) => {
+      // Do something.   
+  });
+  ```
+
+## volumemanager.partition
+
+partition(volId: string, fstype: string): Promise&lt;void&gt;
+
+Asynchronously partitions a disk. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_FORMAT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name      | Type  | Mandatory| Description|
+    | ----------- | ------ | ---- | ---- |
+  | volId    | string | Yes  | ID of the disk to which the volume belongs.|
+  | fstype      | string | Yes  | Partition type.   |
+
+**Return value**
+
+  | Type                     | Description                      |
+   | --------------------- | ----------------------- |
+  | Promise&lt;void&gt;   | Promise used to return the result.             |
+
+**Example**
+
+  ```js
+  let volId = "";
+  let fstype = "";
+  let bool = await volumemanager.partition(volId, fstype);
+  ```
+
+## volumemanager.partition
+
+partition(volId: string, fstype : string, callback: AsyncCallback&lt;void&gt;): void
+
+Asynchronously partitions a disk. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.MOUNT_FORMAT_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.Volume
+
+**Parameters**
+
+  | Name     | Type                                  | Mandatory| Description             |
+  | -------- | --------------------------------------- | ---- | ---------------- |
+  | volId   | string                                  | Yes  | ID of the disk to which the volume belongs.     |
+  | fstype     | string                                  | Yes  | Partition type.          |
+  | callback | callback:AsyncCallback&lt;void&gt;   | Yes  | Callback invoked to return the result.     |
+
+**Example**
+
+  ```js
+  let volId = "";
+  let fstype = "";
+  volumemanager.format(volId, fstype, (error, bool) => {
+      // Do something.   
   });
   ```
 
@@ -172,11 +467,11 @@ Asynchronously unmounts a volume. This API uses a callback to return the result.
 
 ### Attributes
 
-| Name       | Type   | Description                |
+| Name        | Type   | Description                |
 | ----------- | ------- | -------------------- |
-| id          | number  | Volume ID.                |
-| uuid        | string  | Universally unique identifier (UUID) of the volume.              |
+| id          | string  | Volume ID.                |
+| uuid        | string  | UUID of the volume.              |
 | description | string  | Description of the volume.          |
-| removable | boolean | Whether the volume is a removable storage device.|
-| state       | int     | Current volume status.          |
+| removable   | boolean | Whether the volume is a removable storage device.|
+| state       | number  | Volume state.          |
 | path        | string  | Mount address of the volume.        |