byted-vedb-mysql

v2026.09.24

火山引擎 VEDBM(云数据库 VeDB MySQL 版)管理技能。当用户需要创建 VEDBM 实例、查询 VEDBM 实例列表、查看实例详情、管理数据库账号、获取实例连接地址(Endpoints)、或对实例规格进行升级/降级时使用此技能。包含特定关键词:火山引擎云数据库、VEDBM、VeDB MySQL。

GitHub
Install command
npx skhub add bytedance/byted-vedb-mysql
Markdown
SKILL.md

火山引擎 VEDBM 管理技能

本技能用于管理火山引擎 VEDBM(云数据库)实例,包含以下功能:

  1. 创建实例:支持用户自定义实例规格,默认使用 2C8G 规格,用户名 root,密码随机生成
  2. 查看实例列表:查询指定地域下的所有 VEDBM 实例
  3. 查看数据库账号列表:查询指定实例中的所有数据库账号及其状态
  4. 查看实例连接地址:查询指定实例的连接地址信息(域名、端口、IP等)

✨ 新特性

  • 智能规格匹配:支持用户输入简单格式(如 "2c8g"、"4c16g")
  • 灵活默认值:默认使用 2C8G 规格
  • 自动降级/升级:如果用户提供的规格不存在,自动选择最接近的可用规格

使用流程

第一步:收集必要信息

当用户触发此技能时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
VPC ID✅虚拟私有云 ID
子网 ID✅子网 ID
可用区 ID✅可用区(如 cn-guangzhou-a)
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你创建 VEDBM 实例!需要你提供一些信息:

  1. VPC ID 是什么?
  2. 子网 ID 是什么?
  3. 想用哪个可用区?(如 cn-guangzhou-a)
  4. AccessKey ID 是什么?
  5. Secret Access Key 是什么?"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量:

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"
export VEDBM_VPC_ID="你的VPC ID"
export VEDBM_SUBNET_ID="你的子网 ID"
export VEDBM_ZONE_ID="cn-guangzhou-a"

或者使用 .env 文件:

cd scripts
cp .env.example .env
# 编辑 .env 文件填入真实信息

第三步:执行创建

收集完信息后,执行创建命令。

访问密钥配置

方式 1:命令行参数

python scripts/create_vedbm_instance.py \
  --vpc-id <你的VPC ID> \
  --subnet-id <你的子网 ID> \
  --zone-id cn-guangzhou-a \
  --access-key-id <你的AccessKeyId> \
  --secret-access-key <你的SecretAccessKey>

方式 2:环境变量

export VOLCENGINE_ACCESS_KEY="your-access-key-id"
export VOLCENGINE_SECRET_KEY="your-secret-access-key"
export VEDBM_VPC_ID="your-vpc-id"
export VEDBM_SUBNET_ID="your-subnet-id"
export VEDBM_ZONE_ID="cn-guangzhou-a"

python scripts/create_vedbm_instance.py

方式 3:混合使用

可以部分用环境变量,部分用命令行参数:

export VOLCENGINE_ACCESS_KEY="your-access-key-id"
export VOLCENGINE_SECRET_KEY="your-secret-access-key"

python scripts/create_vedbm_instance.py \
  --vpc-id <你的VPC ID> \
  --subnet-id <你的子网 ID> \
  --zone-id cn-guangzhou-a

可用区说明

广州区域可用区:

  • cn-guangzhou-a - 可用区 A
  • cn-guangzhou-c - 可用区 C

注意:没有 cn-guangzhou-b

节点规格

规格CPU内存说明
vedb.mysql.x2.large2核8GB默认,入门级
vedb.mysql.x4.large4核16GB性价比高
vedb.mysql.g4.large4核16GB通用型
vedb.mysql.p4.large4核16GB性能型
vedb.mysql.x4.xlarge8核32GB高性能
vedb.mysql.x8.large16核64GB旗舰级

🎯 规格输入格式

支持多种输入格式:

1. 简写格式(推荐)

  • 2c8g - 2核8GB
  • 4c16g - 4核16GB
  • 8c32g - 8核32GB

2. 只指定 CPU

  • 2c - 自动匹配 2核 的规格
  • 4c - 自动匹配 4核 的规格

3. 只指定内存

  • 8g - 自动匹配 8GB 的规格
  • 16g - 自动匹配 16GB 的规格

4. 完整规格名

  • vedb.mysql.x2.large
  • vedb.mysql.x4.large

🤖 智能匹配规则

如果用户提供的规格不存在,系统会自动选择最接近的规格:

  1. 优先选择大于等于目标配置的规格
  2. CPU 权重 > 内存权重
  3. 如果没有足够大的规格,选择最大的可用规格

示例:

  • 用户输入 3c10g → 自动匹配 4c16g
  • 用户输入 5c20g → 自动匹配 8c32g
  • 用户输入 1c4g → 自动匹配 2c8g(最小规格)

前置条件

  1. 已安装火山引擎 Python SDK:

    pip install volcengine-python-sdk
    
  2. 已配置火山引擎访问凭证(Access Key ID 和 Secret Access Key)

使用方法

运行脚本创建实例:

python scripts/create_vedbm_instance.py

脚本参数

脚本支持以下可选参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-name: 实例名称,默认随机生成
  • --node-spec: 节点规格(可选,默认 2c8g)
    • 支持格式:2c8g、4c16g、vedb.mysql.x2.large
  • --vpc-id: VPC ID(必须提供)
  • --subnet-id: 子网 ID(必须提供)
  • --zone-id: 可用区 ID(必须提供)

输出信息

创建成功后会返回:

  • 实例 ID
  • 连接地址
  • 端口
  • 用户名(root)
  • 密码(随机生成)
  • 使用的规格(含描述和代码)

示例

示例 1:使用默认规格(2c8g)

python scripts/create_vedbm_instance.py \
  --vpc-id vpc-123456 \
  --subnet-id subnet-123456 \
  --zone-id cn-guangzhou-a

示例 2:使用简写规格

python scripts/create_vedbm_instance.py \
  --vpc-id vpc-123456 \
  --subnet-id subnet-123456 \
  --zone-id cn-guangzhou-a \
  --node-spec 4c16g

示例 3:使用完整规格名

python scripts/create_vedbm_instance.py \
  --vpc-id vpc-123456 \
  --subnet-id subnet-123456 \
  --zone-id cn-guangzhou-a \
  --node-spec vedb.mysql.x4.large

示例 4:只指定 CPU

python scripts/create_vedbm_instance.py \
  --vpc-id vpc-123456 \
  --subnet-id subnet-123456 \
  --zone-id cn-guangzhou-a \
  --node-spec 8c

功能二:查看实例列表

使用流程

第一步:收集必要信息

当用户需要查看实例列表时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥
区域(可选)❌查询的区域,默认 cn-guangzhou

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你查看 VEDBM 实例列表!需要你提供一些信息:

  1. AccessKey ID 是什么?
  2. Secret Access Key 是什么?
  3. 要查询哪个区域?(默认 cn-guangzhou)"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用以创建实例的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"
export VEDBM_REGION="cn-guangzhou"  # 可选

使用方法

运行脚本查询实例列表:

python scripts/list_instances.py

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)

输出信息

查询成功后会返回:

  • 区域
  • 实例总数
  • 每个实例的详细信息:
    • 实例 ID
    • 实例名称
    • 实例状态
    • 节点规格
    • 可用区
    • 创建时间

示例

示例 1:使用默认区域(cn-guangzhou)

python scripts/list_instances.py

示例 2:指定区域

python scripts/list_instances.py --region cn-beijing

输出示例

====================================================================================================
✅ VEDBM 实例列表查询成功!
====================================================================================================
区域: cn-guangzhou
实例总数: 2

📋 实例列表:
----------------------------------------------------------------------------------------------------
实例 ID                  实例名称                  状态         规格                可用区          
----------------------------------------------------------------------------------------------------
vedbm-xxx123456         vedbm-instance-123456    Running     vedb.mysql.x2.large cn-guangzhou-a
vedbm-yyy789012         vedbm-instance-789012    Running     vedb.mysql.x4.large cn-guangzhou-c
----------------------------------------------------------------------------------------------------
====================================================================================================

功能三:查看数据库账号列表

使用流程

第一步:收集必要信息

当用户需要查看数据库账号列表时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
实例 ID✅VEDBM 实例 ID
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你查看 VEDBM 实例的数据库账号列表!需要你提供一些信息:

  1. 实例 ID 是什么?
  2. AccessKey ID 是什么?
  3. Secret Access Key 是什么?"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用以创建实例的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"

使用方法

运行脚本查询账号列表:

python scripts/list_db_accounts.py --instance-id <实例ID>

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-id: 实例 ID(必须提供)
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)

输出信息

查询成功后会返回:

  • 实例 ID
  • 区域
  • 账号总数
  • 每个账号的详细信息:
    • 账号名称
    • 账号类型
    • 账号状态

示例

python scripts/list_db_accounts.py \
  --instance-id vedbm-xxx123456

输出示例

======================================================================
✅ 数据库账号列表查询成功!
======================================================================
实例 ID: vedbm-xxx123456
区域: cn-guangzhou
账号总数: 2

📋 账号列表:
----------------------------------------------------------------------
账号名称             账号类型          账号状态        
----------------------------------------------------------------------
root                Super           Available     
testuser            Normal          Available     
----------------------------------------------------------------------
======================================================================

功能四:查看实例连接地址

使用流程

第一步:收集必要信息

当用户需要查看实例连接地址时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
实例 ID✅VEDBM 实例 ID
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你查看 VEDBM 实例的连接地址!需要你提供一些信息:

  1. 实例 ID 是什么?
  2. AccessKey ID 是什么?
  3. Secret Access Key 是什么?"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用其他功能的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"

使用方法

运行脚本查询连接地址:

python scripts/get_instance_endpoint.py --instance-id <实例ID>

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-id: 实例 ID(必须提供)
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)

输出信息

查询成功后会返回:

  • 实例 ID
  • 区域
  • 终端总数
  • 每个终端的详细信息:
    • 终端 ID
    • 终端类型(Primary、Cluster 等)
    • 每个终端的连接地址:
      • 域名
      • 端口
      • IP 地址
      • 网络类型

示例

python scripts/get_instance_endpoint.py \
  --instance-id vedbm-xxx123456

输出示例

================================================================================
✅ 实例连接地址查询成功!
================================================================================
实例 ID: vedbm-xxx123456
区域: cn-guangzhou
终端总数: 2

📍 终端 1:
--------------------------------------------------------------------------------
  终端 ID: endpoint-abc123
  终端类型: Primary

  📡 连接地址:
    地址 1:
      域名: vedbm-xxx123456.rds.volcengine.com
      端口: 3306
      IP地址: 10.0.0.100
      网络类型: Private

📍 终端 2:
--------------------------------------------------------------------------------
  终端 ID: endpoint-def456
  终端类型: Cluster

  📡 连接地址:
    地址 1:
      域名: vedbm-xxx123456-cluster.rds.volcengine.com
      端口: 3306
      IP地址: 10.0.0.101
      网络类型: Private
--------------------------------------------------------------------------------
================================================================================

功能五:查看实例详情

使用流程

第一步:收集必要信息

当用户需要查看实例详情时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
实例 ID✅VEDBM 实例 ID
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你查看 VEDBM 实例详情!需要你提供一些信息:

  1. 实例 ID 是什么?
  2. AccessKey ID 是什么?
  3. Secret Access Key 是什么?"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用其他功能的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"

使用方法

运行脚本查询实例详情:

python scripts/describe_instance.py --instance-id <实例ID>

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-id: 实例 ID(必须提供)
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)
  • --full: 显示完整属性列表(调试用)

输出信息

查询成功后会返回:

基本信息

  • 实例 ID
  • 实例名称
  • 实例状态
  • 创建时间
  • 项目名称

规格信息

  • 节点规格
  • 配置(CPU核数 + 内存)
  • 节点数量
  • 规格系列

存储信息

  • 已用存储
  • 存储计费类型

网络信息

  • 区域
  • 可用区
  • VPC ID
  • 子网 ID

数据库信息

  • 数据库版本
  • 内核版本
  • 时区

计费信息

  • 计费类型
  • 计费状态
  • 删除保护

节点详情

  • 每个节点的 ID、类型、规格、可用区

示例

示例 1:查询实例详情

python scripts/describe_instance.py \
  --instance-id vedbm-xxx123456

示例 2:显示完整属性列表(调试用)

python scripts/describe_instance.py \
  --instance-id vedbm-xxx123456 \
  --full

输出示例

====================================================================================================
✅ VEDBM 实例详情查询成功!
====================================================================================================

📋 基本信息:
----------------------------------------------------------------------------------------------------
  实例 ID:        vedbm-4wuvdt3jhlce
  实例名称:      free
  实例状态:      Running
  创建时间:      2026-04-03T05:35:38Z
  项目名称:      default

💻 规格信息:
----------------------------------------------------------------------------------------------------
  节点规格:      vedb.mysql.g4.large
  配置:          4核 16GB
  节点数量:      2
  规格系列:      General

💾 存储信息:
----------------------------------------------------------------------------------------------------
  已用存储:      2.093 GiB
  存储计费类型:  PostPaid

🌐 网络信息:
----------------------------------------------------------------------------------------------------
  区域:          cn-guangzhou
  可用区:        cn-guangzhou-a
  VPC ID:        vpc-3f03n0s2v50qo72200s6jj8ni
  子网 ID:       subnet-11wfhusxgt05c40yrhczqa9cl

🗄️  数据库信息:
----------------------------------------------------------------------------------------------------
  数据库版本:    MySQL_8_0
  内核版本:      3.3.2.7
  时区:          UTC -01:00

💰 计费信息:
----------------------------------------------------------------------------------------------------
  计费类型:      PostPaid
  计费状态:      Normal
  删除保护:      disabled

🔧 节点详情:
----------------------------------------------------------------------------------------------------
  节点 ID                               类型           规格                        可用区
----------------------------------------------------------------------------------------------------
  vedbm-4wuvdt3jhlce-0                ReadOnly     vedb.mysql.g4.large       cn-guangzhou-a
  vedbm-4wuvdt3jhlce-1                Primary      vedb.mysql.g4.large       cn-guangzhou-a
====================================================================================================

功能六:升级实例规格

使用场景

  1. 用户指定规格:如果用户指定了规格,就按照用户指定的规格做变更
  2. 自动升级:如果用户没有指定规格,先查看当前的实例规格,然后默认按照CPU的规格升级一个等级
  3. 不跨规格类型:通用规格只能在通用规格内升级,独享规格只能在独享规格内升级
  4. 最大规格提示:如果没有办法升级,告知用户当前规格已经是最大的了无法升级
  5. 超时处理:如果升级任务10分钟还未执行完成,则告知用户通过控制台关注任务状态

使用流程

第一步:收集必要信息

当用户需要升级实例规格时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
实例 ID✅VEDBM 实例 ID
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥
目标规格(可选)❌不提供则自动升级一个等级

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你升级 VEDBM 实例规格!需要你提供一些信息:

  1. 实例 ID 是什么?
  2. AccessKey ID 是什么?
  3. Secret Access Key 是什么?
  4. 目标规格是什么?(可选,不提供则自动升级一个等级)"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用其他功能的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"

规格类型说明

系列说明可用规格
G4 系列(通用型,默认)通用型4c16g → 8c32g → 16c64g → 32c128g
X4 系列(标准型)标准型4c16g → 8c32g → 16c64g → 32c128g → 64c256g
X8 系列(标准型X8)标准型X88c32g → 16c64g → 32c128g → 64c256g → 96c384g → 128c512g
G8 系列(通用型G8)通用型G816c64g

⚠️ 注意:不支持跨系列升级!

使用方法

运行脚本升级实例规格:

python scripts/upgrade_instance_spec.py --instance-id <实例ID>

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-id: 实例 ID(必须提供)
  • --target-spec: 目标规格(可选,不提供则自动升级一个等级)
    • 支持格式:2c8g、4c16g、vedb.mysql.x4.large
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)

输出信息

升级成功后会返回:

  • 实例 ID
  • 原规格
  • 新规格
  • 规格代码
  • 是否完成(如果10分钟内完成)

示例

示例 1:自动升级一个等级(推荐)

python scripts/upgrade_instance_spec.py \
  --instance-id vedbm-xxx123456

示例 2:指定目标规格(使用简写格式)

python scripts/upgrade_instance_spec.py \
  --instance-id vedbm-xxx123456 \
  --target-spec 4c16g

示例 3:指定目标规格(使用完整规格名)

python scripts/upgrade_instance_spec.py \
  --instance-id vedbm-xxx123456 \
  --target-spec vedb.mysql.x4.large

输出示例

自动升级成功

================================================================================
✅ VEDBM 实例规格升级成功!
================================================================================
实例 ID: vedbm-xxx123456
原规格: vedb.mysql.x2.large
新规格: 4核16GB
规格代码: vedb.mysql.x4.large
================================================================================

已经是最大规格

================================================================================
❌ VEDBM 实例规格升级失败!
================================================================================
错误信息: 当前规格 'vedb.mysql.x8.large' 已经是 X 系列的最大规格,无法继续升级
实例 ID: vedbm-xxx123456
================================================================================

等待超时(10分钟)

================================================================================
⏳ VEDBM 实例规格变更请求已提交
================================================================================
实例 ID: vedbm-xxx123456
原规格: vedb.mysql.x2.large
目标规格: 4核16GB
规格代码: vedb.mysql.x4.large

⚠️  注意: 规格变更请求已提交,但等待超时(10分钟)。请通过火山引擎控制台关注任务状态。
================================================================================

跨系列升级被拒绝

================================================================================
❌ VEDBM 实例规格升级失败!
================================================================================
错误信息: 不支持跨规格类型升级(当前: X 系列, 目标: G 系列)
实例 ID: vedbm-xxx123456
================================================================================

功能七:降级实例规格

使用场景

  1. 用户指定规格:如果用户指定了规格,就按照用户指定的规格做变更
  2. 自动降级:如果用户没有指定规格,先查看当前的实例规格,然后默认按照CPU的规格降级一个等级
  3. 不跨规格类型:通用规格只能在通用规格内降级,独享规格只能在独享规格内降级
  4. 最小规格提示:如果没有办法降级,告知用户当前规格已经是最小的了无法降级
  5. 超时处理:如果降级任务10分钟还未执行完成,则告知用户通过控制台关注任务状态

使用流程

第一步:收集必要信息

当用户需要降级实例规格时,先检查是否有必要信息。如果没有,引导用户提供:

信息必填说明
实例 ID✅VEDBM 实例 ID
AccessKey ID✅火山引擎访问密钥 ID
Secret Access Key✅火山引擎秘密访问密钥
目标规格(可选)❌不提供则自动降级一个等级

第二步:信息收集方式

方式 A:对话引导(推荐首次使用)

询问用户:

"好的,我来帮你降级 VEDBM 实例规格!需要你提供一些信息:

  1. 实例 ID 是什么?
  2. AccessKey ID 是什么?
  3. Secret Access Key 是什么?
  4. 目标规格是什么?(可选,不提供则自动降级一个等级)"

方式 B:环境变量配置(推荐频繁使用)

提示用户配置环境变量(可以复用其他功能的配置):

# 配置环境变量
export VOLCENGINE_ACCESS_KEY="你的AccessKeyId"
export VOLCENGINE_SECRET_KEY="你的SecretAccessKey"

规格类型说明

系列说明可用规格
G4 系列(通用型,默认)通用型4c16g ← 8c32g ← 16c64g ← 32c128g
X4 系列(标准型)标准型4c16g ← 8c32g ← 16c64g ← 32c128g ← 64c256g
X8 系列(标准型X8)标准型X88c32g ← 16c64g ← 32c128g ← 64c256g ← 96c384g ← 128c512g
G8 系列(通用型G8)通用型G816c64g

⚠️ 注意:不支持跨系列降级!

使用方法

运行脚本降级实例规格:

python scripts/downgrade_instance_spec.py --instance-id <实例ID>

脚本参数

脚本支持以下参数:

  • --region: 区域,默认 cn-guangzhou
  • --instance-id: 实例 ID(必须提供)
  • --target-spec: 目标规格(可选,不提供则自动降级一个等级)
    • 支持格式:2c8g、4c16g、vedb.mysql.x4.large
  • --access-key-id: 访问密钥 ID(或环境变量 VOLCENGINE_ACCESS_KEY)
  • --secret-access-key: 秘密访问密钥(或环境变量 VOLCENGINE_SECRET_KEY)

输出信息

降级成功后会返回:

  • 实例 ID
  • 原规格
  • 新规格
  • 规格代码
  • 是否完成(如果10分钟内完成)

示例

示例 1:自动降级一个等级(推荐)

python scripts/downgrade_instance_spec.py \
  --instance-id vedbm-xxx123456

示例 2:指定目标规格(使用简写格式)

python scripts/downgrade_instance_spec.py \
  --instance-id vedbm-xxx123456 \
  --target-spec 4c16g

示例 3:指定目标规格(使用完整规格名)

python scripts/downgrade_instance_spec.py \
  --instance-id vedbm-xxx123456 \
  --target-spec vedb.mysql.x4.large

输出示例

自动降级成功

================================================================================
✅ VEDBM 实例规格降级成功!
================================================================================
实例 ID: vedbm-xxx123456
原规格: vedb.mysql.x4.large
新规格: 4核16GB
规格代码: vedb.mysql.x4.large
================================================================================

已经是最小规格

================================================================================
❌ VEDBM 实例规格降级失败!
================================================================================
错误信息: 当前规格 'vedb.mysql.x4.large' 已经是 X4 系列的最小规格,无法继续降级
实例 ID: vedbm-xxx123456
================================================================================

等待超时(10分钟)

================================================================================
⏳ VEDBM 实例规格变更请求已提交
================================================================================
实例 ID: vedbm-xxx123456
原规格: vedb.mysql.x4.large
目标规格: 4核16GB
规格代码: vedb.mysql.x4.large

⚠️  注意: 规格变更请求已提交,但等待超时(10分钟)。请通过火山引擎控制台关注任务状态。
================================================================================

跨系列降级被拒绝

================================================================================
❌ VEDBM 实例规格降级失败!
================================================================================
错误信息: 不支持跨规格类型降级(当前: X 系列, 目标: G 系列)
实例 ID: vedbm-xxx123456
================================================================================
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Apache-2.0

Source path

skills/byted-vedb-mysql

Default branch

main

Latest commit

db8aaa9

Tree SHA

f2e4656