文档中心>云 API>公告>API 2.0接口迁移指引汇总

API 2.0接口迁移指引汇总

最近更新时间:2025-06-05 16:21:32

我的收藏
腾讯云 API 已全面升级到 API 3.0。相比 API 2.0,API 3.0 时延更低、接口标准更规范、开发工具也更丰富易用。若您仍在使用 API 2.0 接口,为避免后续服务下线影响业务正常运行,请参考以下指引尽快完成接口迁移。

查看 API 2.0 调用数据

云 API 控制台 信息中心的 API 2.0 页面,您可以查看到当前账号及其子账号的 API 2.0 调用数据,包括用户数、产品数、接口数、调用次数等。如需查看调用了哪些接口,可在“调用分布”模块将维度切换到「接口」;如需查看有哪些子账号调用了 API 2.0 接口,可在“调用分布”模块将维度切换到「用户」。利用这些数据,您可以排查服务中具体的 API 2.0 调用情况,然后参考以下指引完成接口迁移。更多数据看板功能说明请参见 API 2.0 使用手册
说明:
若登录账号为子账号,仅可查看当前账号的调用数据。如需查看完整 API 2.0 调用数据,建议使用主账号登录。
API 2.0 数据看板目前仍在灰度测试阶段。如果您有查看 API 2.0 数据的需求但无法看到相关入口,请联系 售后支持



独立产品迁移指引文档

其他产品 API 2.0切换3.0接口对应

专线接入 DC

API 2.0 接口
API 3.0 接口
DescribeDirectConnectTunnels
DescribeDirectConnects
DeleteDirectConnectTunnel

容器服务 CCS

API 2.0 接口
API 3.0 接口
CheckClusterRouteTableCidrConflict
CreateClusterRoute
CreateClusterRouteTable
CreateClusterService
DeleteClusterRoute
DescribeCluster
DescribeClusterContainer
DescribeClusterInstances
DescribeClusterRoute
DescribeClusterRouteTable
DescribeClusterService
DescribeClusterServiceInfo
DescribeInstanceLog
DescribeServiceEvent
DescribeServiceInstance
GetClustersResourceStatus
已下线,无对应V3接口
GetLogDaemonStatus
已下线,无对应V3接口
ModifyClusterServiceImage
RedeployClusterService

云服务器 CVM

API 2.0 接口
API 3.0 接口
说明
DescribeAvailabilityZones
-
DescribeZonesV3
直接替代
DescribeZoneInstanceConfigInfosV3
直接替代
DescribeInstanceFamilyConfigsV3
直接替代
InquiryPriceRunInstancesV3
直接替代
RenewInstancesV3
直接替代
InquiryPriceRenewInstancesV3
直接替代
TerminateInstancesV3
直接替代
RunInstancesV3
直接替代
DescribeImagesV3
直接替代
DescribeInstances
1. uuid 转化为 InstanceIds
2. 其他过滤条件放到 Filters 中维护
DescribeInstancesV3
直接替代
DescribeInstancesStatusV3
直接替代
DescribeKeyPairs
keyIds -> KeyIds不再支持 keyName 过滤
DescribeZoneAbility
-
InquiryInstancePrice
不同询价场景使用不同的新接口替代:
创建 -> InquiryPriceRunInstances
续费 -> InquiryPriceRenewInstances
重装 -> InquiryPriceResetInstance
配置系统升级 -> InquiryPriceResetInstancesType
扩容实例磁盘 -> InquiryPriceResizeInstanceDisks
调整实例计费模式 -> InquiryPriceModifyInstancesChargeType
ModifyInstanceAttributes
1. ipList, uuidList 新接口不再支持,需要转化为 InstanceIds
2. alias 在新接口中是 InstanceName
RenewInstance
goodsDetail 中的信息需要提取到外层
1. uuid 转化为 InstanceIds
2. 新接口使用 InstanceChargePrepaid 传入预付费的相关信息,包括 Period(代替 timeSpan),TimeUnit(支持按天/月两种模式)
3. purchaseSource 不再需要传入
ResetInstancePassword
1. uuidList 新接口不再支持,需要转化为 InstanceIds
2. password 转化为 Password
3. hardPowerOffFlag 转化为 ForceStop
RestartInstances
1. uuidList 新接口不再支持,需要转化为 InstanceIds
2. softPowerOffFlag/hardPowerOffFlag 转化为 ForceReboot
RunInstances
goodsDetail 中的信息需要提取到外层,字段较多不一一列举
RunInstancesHour
RunInstances(按量计费和包年包月在 v3 收敛到同一个接口)
goodsDetail 中的信息需要提取到外层,字段较多不一一列举
StartInstances
uuidList 新接口不再支持,需要转化为 InstanceIds
StopInstances
1. uuidList 新接口不再支持,需要转化为 InstanceIds
2. softPowerOffFlag/hardPowerOffFlag 转化为 ForceStop3. actionType 转化为 StopType

账号服务 account

API 2.0 接口
API 3.0 接口
DescribeProject

SSL 证书 wss

API 2.0 接口
API 3.0 接口
CertDelete
CertGetList
CertUpload

费用中心 trade

API 2.0 接口
API 3.0 接口
DescribeDealsByCond
PayDealsV2
PayDeals

安全凭证服务 sts

API 2.0 接口
API 3.0 接口
GetFederationToken
AssumeRole