操作指南

最佳实践

故障处理

API 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT
文档中心 > 云服务器 > 操作指南 > 实例 > 销毁/退还实例 > 使用 API 销毁/退还包年包月实例及挂载的云硬盘

操作场景

本文档使用了腾讯云开发者工具套件(SDK)3.0及云 API 接口,实现在销毁包年包月云服务器实例时,同时销毁已挂载至该实例的所有包年包月云硬盘。本文档适用于销毁仅含有包年包月云硬盘的包年包月云服务器,提供 Python 语言的示例代码,请您结合实际情况进行使用。

注意

销毁/退还云服务器实例及云硬盘所造成的影响请参见 相关影响

前提条件

  • 已具备计费模式为包年包月的云服务器实例,且该实例已挂载云硬盘。
  • 已前往 API 密钥管理 页面获取 SecretID 及 SecretKey。

操作步骤

安装依赖环境及 SDK

请根据您实际使用的开发语言,安装对应依赖环境及 SDK:

  1. 安装 Python 3.6 - 3.9 版本,详情请参见 Python 官网
  2. 执行以下命令,安装 Python SDK。更多信息请参见 Tencent Cloud SDK 3.0 for Python
    pip install --upgrade tencentcloud-sdk-python

运行示例代码

示例代码如下,您可根据实际情况进行使用:

main 程序示例代码:

-- coding: utf-8 --
import sys
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from TerminateTotalInstance import TerminateTotalInstance

if __name__ == '__main__':
try:
region = "ap-beijing"
ins = "ins-irmer45l"
TerminateTotalInstance(region=region).process(instance_id=instance_id)
print("done!")
except TencentCloudSDKException as e:
print(e)
except Exception as e:
print("failed")

销毁实例及云硬盘示例代码:
# -*- coding: utf-8 -*-
import logging
import time

from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.cvm.v20170312 import cvm_client, models as cvm_models
from tencentcloud.cbs.v20170312 import cbs_client, models as cbs_models


class TerminateTotalInstance(object):
def __init__(self, region):
# 默认读取环境变量 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY 获取 secretId 和 secretKey
# 更多凭证管理方式,请参考:https://github.com/TencentCloud/tencentcloud-sdk-python#%E5%87%AD%E8%AF%81%E7%AE%A1%E7%90%86
self.cred = credential.EnvironmentVariableCredential().get_credential()
self.cbs_client = self.__create_cbs_client(region)
self.cvm_client = self.__create_cvm_client(region)

def get_cred(self):
# 如果是根据token获取的身份, 这里需要判断一下token是否有效
# 如果无效, 重新获取cred
if not self.cred:
self.cred = credential.EnvironmentVariableCredential().get_credential()
return self.cred
def process(self, instance_id):
# 获取云盘
cbs_ids = self.describe_disks_for_instance(instance_id)

# 退还实例
cvm_resp, cvm_api_errors = self.terminate_instance(instance_id)
if cvm_api_errors:
raise Exception(cvm_api_errors)

# 确认子机退还成功
is_succ, cvm_api_errors = self.check_terminate_instance_success(instance_id)
if not is_succ:
raise Exception(cvm_api_errors)

# 解挂并批量退还云盘
if not cbs_ids:
return
cbs_resp, cbs_api_errors = self.detach_disks(cbs_ids)
if cbs_api_errors:
raise Exception(cbs_api_errors)

cbs_resp, cbs_api_errors = self.terminate_disks_for_instance(cbs_ids)
if cbs_api_errors:
raise Exception(cbs_api_errors)

def terminate_instance(self, instance_id):
# 调用失败历史
cvm_api_errors = []

for i in range(0, 5):
try:
req = cvm_models.TerminateInstancesRequest()
params = '{"InstanceIds":["%s"]}' % instance_id
req.from_json_string(params)
resp = self.cvm_client.TerminateInstances(req)
cvm_api_errors.clear()
return resp, cvm_api_errors

except TencentCloudSDKException as e:
# 失败重试,记录报错
cvm_api_errors.append(e)
logging.error(e)
time.sleep(3)

return None, cvm_api_errors

def check_terminate_instance_success(self, instance_id):
# 调用失败历史
cvm_api_errors = []

for _ in range(0, 30):
try:
req = cvm_models.DescribeInstancesStatusRequest()
params = '{"InstanceIds":["%s"]}' % instance_id
req.from_json_string(params)
resp = self.cvm_client.DescribeInstancesStatus(req)
cvm_api_errors.clear()
if resp.TotalCount > 0:
if resp.InstanceStatusSet[0].InstanceState == "SHUTDOWN":
return True, cvm_api_errors
else:
logging.error(resp)

except TencentCloudSDKException as e:
# 失败重试,记录报错
cvm_api_errors.append(e)
logging.error(e)
time.sleep(6)

return False, cvm_api_errors

def describe_disks_for_instance(self, instance_id):
# 获取绑定在子机上的数据盘
req = cbs_models.DescribeDisksRequest()
params = '{"Filters": [ { "Name": "instance-id", "Values": [ "%s" ]}]}' % instance_id
req.from_json_string(params)
disks = self.cbs_client.DescribeDisks(req)
if hasattr(disks, "DiskSet"):
cbs_ids = [disk.DiskId for disk in disks.DiskSet if disk.DiskUsage == "DATA_DISK"]
else:
cbs_ids = list()
return cbs_ids

def detach_disks(self, cbs_ids):
# 解挂数据盘
cbs_api_errors = []
for _ in range(0, 5):
try:
req = cbs_models.DetachDisksRequest()
req.DiskIds = cbs_ids
resp = self.cbs_client.DetachDisks(req)
cbs_api_errors.clear()
return resp, cbs_api_errors

except TencentCloudSDKException as e:
# 失败重试,记录报错
cbs_api_errors.append(e)
logging.error(e)
time.sleep(3)

return None, cbs_api_errors

def terminate_disks_for_instance(self, cbs_ids):
# 退还数据盘
cbs_api_errors = []
for _ in range(0, 10):
try:
req = cbs_models.TerminateDisksRequest()
req.DiskIds = cbs_ids
resp = self.cbs_client.TerminateDisks(req)
cbs_api_errors.clear()
return resp, cbs_api_errors

except TencentCloudSDKException as e:
# 失败重试,记录报错
cbs_api_errors.append(e)
logging.error(e)
time.sleep(6)
return None, cbs_api_errors

def __create_cbs_client(self, region):
http_profile = HttpProfile()
http_profile.endpoint = "cbs.tencentcloudapi.com"

client_profile = ClientProfile()
client_profile.httpProfile = http_profile
return cbs_client.CbsClient(self.get_cred(), region, client_profile)

def __create_cvm_client(self, region):
http_profile = HttpProfile()
http_profile.endpoint = "cvm.tencentcloudapi.com"

client_profile = ClientProfile()
client_profile.httpProfile = http_profile
return cvm_client.CvmClient(self.get_cred(), region, client_profile)

目录