# 自动扩容实例的磁盘空间
#### 操作场景
DDS实例支持存储空间自动扩容，在实例存储空间达到阈值时，会触发自动扩容。
当前DDS支持[创建实例](https://support.huaweicloud.com/usermanual-dds/dds_03_0199.html)后设置存储空间自动扩容策略，本章节介绍创建实例后如何设置存储空间自动扩容。
#### 权限配置
如果您使用的是IAM用户，在使用存储空间自动扩容功能前需要配置DDS服务和IAM服务相应的权限。具体操作如下：
1. 配置DDS服务的"DDS FullAccess"权限。
2. 配置IAM服务的细粒度权限。
   在IAM控制台配置如下IAM权限策略，具体操作请参见[创建自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html)。
   ```
   {
        "Version":"1.1",
        "Statement":[
            {
                "Effect":"Allow",
                "Action":[
                    "iam:permissions:listRolesForAgencyOnProject",
                    "iam:permissions:grantRoleToGroupOnProject",
                    "iam:agencies:createAgency",
                    "iam:agencies:listAgencies",
                    "iam:roles:listRoles",
                    "iam:roles:createRole"
                ]
            }
        ]
    }
   ```
   
3. [创建用户组并授权](https://support.huaweicloud.com/usermanual-iam/iam_03_0001.html)
   您可以在IAM控制台创建用户组，并授予该用户组[2]中创建的自定义权限和Security Administrator系统角色。
   
4. [将用户加入用户组](https://support.huaweicloud.com/usermanual-iam/iam_03_0002.html)
   以主账号或者具有IAM权限的IAM用户登录控制台，将需要设置存储空间自动扩容的实例所属的IAM用户，加入[2]中创建的用户组，此时该IAM用户享有该用户组配置的权限。
   
 
#### 使用须知
- 账户需要有足够的余额，才可进行自动扩容。

- 包周期实例存在未完成订单时，不会自动扩容。

- 只支持DDS 副本集和集群实例。
- 实例状态为"正常"和"存储空间满"时可以进行扩容。
- 副本集实例规格小于8U时，自动扩容上限为5000GB；大于等于8U时，自动扩容上限为10000GB。集群实例任意shard规格小于8U时，自动扩容上限为5000GB；所有shard规格大于等于8U时，自动扩容上限为10000GB。

- 实例在进行规格变更、补丁升级、重启时，磁盘不能自动扩容。
- 存在只读节点的副本集和集群实例不支持该操作。
- 开启自动扩容前，需要[手动创建委托RDSAccessProjectResource](https://support.huaweicloud.com/dds_faq/dds_faq_0221.html)，该委托用户可见，删除委托会导致自动扩容失败。
- 磁盘扩容时，操作日志的大小会根据当前磁盘的总容量进行调整，在操作日志调整期间需要获取锁。因此扩容磁盘前需要确认实例上不存在正在运行的，运行时长超过10秒的的增删改查命令。否则磁盘扩容期间，实例可能会产生锁等待等问题。用户可以通过智能DBA中的会话管理或db.currentOp()命令来确认当前是否存在正在执行的长耗时命令。
 
#### 操作步骤
1. [登录管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/console/#/login)。
2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002225047777.png)，选择区域和项目。
3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002189602180.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
4. 在"实例管理"页面，选择指定的实例，单击实例名称，进入"基本信息"页面。
5. 在"存储空间"区域，单击"自动扩容"。 
   图1自动扩容   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002225271849.png "点击放大")
   
   
   
6. 开启存储空间自动扩容，并设置自动扩容的触发条件和上限。 
   图2扩容设置   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002430191073.png "点击放大")
   表1参数说明 
   | 参数名称     | 描述                                                                                                                                   |
   |:---|:---|
   | 自动扩容     | 存储空间自动扩容开关。                                                                                                                          |
   | 存储容量使用率  | 触发自动扩容阈值，目前支持选择80、85和90，单位%。当前已使用存储空间百分比大于等于总存储空间该阈值时，就会触发自动扩容。集群实例的自动扩容阈值指的是每个shard。                                                |
   | 扩容步长     | 自动扩容当前存储空间的百分比，目前支持选择10、15和20，您可以根据需要选择合适的扩容步长。非10倍数向上取整，小数点后四舍五入，默认一次最小10GB，账户余额不足时，会导致包年包月实例扩容失败。                                  |
   | 存储自动扩容上限 | 用户设置后实际支持的最大存储空间。副本集实例规格小于8U时，自动扩容上限为5000GB；大于等于8U时，自动扩容上限为10000GB。集群实例任意shard规格小于8U时，自动扩容上限为5000GB；所有shard规格大于等于8U时，自动扩容上限为10000GB。 |
      
   
   
7. 单击"确定"。
 
#### 相关API
| API                                                                     | 说明          |
|:---|:---|
| [设置磁盘自动扩容策略](https://support.huaweicloud.com/api-dds/dds_api_0270.html) | 设置磁盘自动扩容策略。 |
| [查询磁盘自动扩容策略](https://support.huaweicloud.com/api-dds/dds_api_0271.html) | 查询磁盘自动扩容策略。 |