初始化存储实例
=======

#### 约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备；从6.1.0(23)版本开始，新增支持PC/2in1设备。

#### 前提条件

已[开通云存储服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-enable-storage)。

#### 操作步骤

调用[cloudStorage.bucket](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudstorage#bucket)初始化一个存储实例。支持使用两种方式初始化实例：

*   使用默认实例
    
    import { cloudStorage } from '@kit.CloudFoundationKit';
    
    let bucket: cloudStorage.StorageBucket = cloudStorage.bucket(); // 将启动异步任务查询云侧默认实例
    
*   使用指定的实例
    
    import { cloudStorage } from '@kit.CloudFoundationKit';
    
    let bucket: cloudStorage.StorageBucket = cloudStorage.bucket('bucket001-2wezr'); // 指定bucket001-2wezr实例
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7e/v3/6LPAobKQRAKoovkd6b-GRw/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073603Z&HW-CC-Expire=86400&HW-CC-Sign=6DDB8034BCF811D58675FDFE1C9D11B64E1DCBFE20376472A46E0560A9DC4948)
    
    以“使用指定的实例”方式初始化云存储实例，请确保当前云侧存在该存储实例，否则后续操作将出现找不到存储实例的错误。在云侧创建新的存储实例，可参考[存储实例管理](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-storage-manage-bucket-0000001281294006)。