云服务器使用 API 销毁/退还包年包月实例及挂载的云硬盘-操作指南-文档中心-腾讯云

操作场景
本文档使用了腾讯云开发者工具套件（SDK）3.0及云 API 接口，实现在销毁包年包月云服务器实例时，同时销毁已挂载至该实例的所有包年包月云硬盘。本文档适用于销毁仅含有包年包月云硬盘的包年包月云服务器，提供 Python 语言的示例代码，请您结合实际情况进行使用。
注意
销毁/退还云服务器实例及云硬盘所造成的影响请参见 相关影响。
前提条件
已具备计费模式为包年包月的云服务器实例，且该实例已挂载云硬盘。
已前往 API 密钥管理 页面获取 SecretID 及 SecretKey。
操作步骤
安装依赖环境及 SDK
请根据您实际使用的开发语言，安装对应依赖环境及 SDK：
Python
1. 安装 Python 3.6 - 3.9 版本，详情请参见 Python 官网。
2. 执行以下命令，安装 Python SDK。更多信息请参见 Tencent Cloud SDK 3.0 for Python。
pip install --upgrade tencentcloud-sdk-python
运行示例代码
示例代码如下，您可根据实际情况进行使用：
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)
﻿
﻿
使用 API 销毁/退还包年包月实例及挂载的云硬盘

本页目录：

操作场景

前提条件

操作步骤

安装依赖环境及 SDK

运行示例代码
