tencentcloud-manager（腾讯云管家）

TencentCloud-Manager - 腾讯云资源统一管理技能

📋 技能说明

腾讯云资源统一管理入口，提供 CVM 云服务器、Lighthouse 轻量应用服务器、COS 对象存储的创建、配置和运维管理。

入口组件

本技能是腾讯云管理的统一入口。你也可以直接使用各分支技能：

核心功能

✅ 资源创建与配置

• CVM 云服务器实例管理
• Lighthouse 轻量服务器管理
• COS 存储桶与文件管理

✅ 运维管理

• 实例启停与重启
• 监控与状态查询
• 生命周期管理
• 批量操作

✅ 成本优化

• 促销方案查询与对比
• 存储类型成本估算
• 资源配置建议

✅ 安全管理

• 子用户权限配置
• 凭证外部化管理
• 操作审计日志

💰 价格参考

⚠️ 注意: 以下价格为参考区间（更新于 2026-03-29），实际价格以腾讯云官网实时查询为准。

CVM 云服务器

Lighthouse 轻量服务器

COS 对象存储

查询实时价格

from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查询 CVM 促销
tcm.show_promotions(service='cvm')

# 查询 Lighthouse 促销
tcm.show_promotions(service='lighthouse')

⚠️ 前置配置 (必须完成)

步骤 1: 创建腾讯云子用户

1. 访问 https://console.cloud.tencent.com/cam/capi
2. 登录腾讯云账号
3. 创建子用户（如：resource-manager）
4. 复制 SecretId 和 SecretKey

步骤 2: 配置子用户权限

推荐策略: 创建自定义策略，授予最小必要权限

CVM 管理权限

{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "cvm:Describe*", "cvm:RunInstances", "cvm:StartInstances",
        "cvm:StopInstances", "cvm:RestartInstances", "cvm:ModifyInstancesAttribute",
        "cvm:RenewInstances", "vpc:DescribeSecurityGroups", "vpc:CreateSecurityGroup"
      ],
      "resource": "*"
    }
  ]
}

Lighthouse 管理权限

{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "lighthouse:Describe*", "lighthouse:CreateInstance",
        "lighthouse:StartInstances", "lighthouse:StopInstances",
        "lighthouse:RestartInstances", "lighthouse:ModifyInstancesAttribute",
        "lighthouse:RenewInstance"
      ],
      "resource": "*"
    }
  ]
}

COS 管理权限

{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "name/cos:GetBucket", "name/cos:PutBucket", "name/cos:ListBucket",
        "name/cos:GetObject", "name/cos:PutObject", "name/cos:DeleteObject",
        "name/cos:PutBucketLifecycle", "name/cos:GetBucketLifecycle"
      ],
      "resource": "*"
    }
  ]
}

步骤 3: 配置凭证到.env 文件

cp skills/tencentcloud-manager/config/.env.example \
   skills/tencentcloud-manager/config/.env

vim skills/tencentcloud-manager/config/.env

TENCENT_SECRET_ID=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxx
TENCENT_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxx
TENCENT_REGION=ap-singapore
RESOURCE_PREFIX=resource
BUDGET_ALERT=100

步骤 4: 安装依赖

pip3 install --break-system-packages \
  tencentcloud-sdk-python \
  cos-python-sdk-v5 \
  python-dotenv

🚀 快速开始

方式 1: 使用统一入口

from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查看所有可用服务
tcm.show_services()

# 查询促销方案
tcm.show_promotions(service='lighthouse')

# 创建资源
instance = tcm.create_resource(
    service='lighthouse',
    plan_id='new-2c4g',
    instance_name='my-server'
)

方式 2: 直接使用各服务管理器

from tencentcloud_cvm import CVMManager
cvm = CVMManager()
cvm.show_promotions()

from tencentcloud_lighthouse import LighthouseManager
lh = LighthouseManager()
lh.show_blueprints()

from tencentcloud_cos import COSManager
cos = COSManager()
cos.create_bucket(bucket_name='my-bucket')

📚 Cookbook - 常用场景

场景 1: 创建个人博客服务器

from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查看促销方案
tcm.show_promotions(service='lighthouse')

# 创建轻量服务器（使用 WordPress 镜像）
instance = tcm.create_resource(
    service='lighthouse',
    plan_id='new-1c1g',
    blueprint_id='bp-wordpress',
    instance_name='my-blog',
    period=12
)

print(f"服务器已创建：{instance['PublicAddress']}")

预估成本: ~¥60-80/年（新人特惠）

场景 2: 创建数据整理服务器

tcm = TencentCloudManager()

# 创建 CVM 实例（按量付费）
instance = tcm.create_resource(
    service='cvm',
    plan_id='payg-2c4g',
    image_id='img-ubuntu-2204',
    instance_name='data-collector',
    system_disk_size=100,
    bandwidth=5
)

# 设置定时关机
tcm.schedule_shutdown(
    service='cvm',
    instance_id=instance['InstanceId'],
    shutdown_time='23:00',
    timezone='Asia/Shanghai'
)

预估成本: ~¥130-180/月（按实际使用计费）

场景 3: 配置对象存储并设置生命周期

# 创建存储桶
bucket = tcm.create_cos_bucket(
    bucket_name='my-data-bucket',
    region='ap-singapore',
    storage_class='STANDARD'
)

# 上传文件
tcm.upload_to_cos(
    bucket=bucket['bucket'],
    local_path='/tmp/data.parquet',
    key='data/2024/03/29/data.parquet'
)

# 设置生命周期
tcm.set_cos_lifecycle(
    bucket=bucket['bucket'],
    rules=[
        {
            'id': 'data-lifecycle',
            'prefix': 'data/',
            'transitions': [
                {'days': 7, 'storage_class': 'STANDARD_IA'},
                {'days': 30, 'storage_class': 'ARCHIVE'}
            ]
        }
    ]
)

预估成本: ~¥35-50/月（生命周期优化后）

场景 4: 批量管理服务器

# 查询所有实例
instances = tcm.list_all_instances()

# 批量开机
for inst in instances:
    if inst['state'] == 'STOPPED':
        tcm.start_resource(inst['service'], inst['id'])

# 批量关机
for inst in instances:
    if inst['state'] == 'RUNNING':
        tcm.stop_resource(inst['service'], inst['id'])

场景 5: 监控资源成本

# 查询所有资源成本
cost_report = tcm.get_cost_report()

print(f"总月成本：¥{cost_report['total_monthly_cost']}")

# 成本优化建议
suggestions = tcm.get_cost_optimization_suggestions()
for suggestion in suggestions:
    print(f"💡 {suggestion}")

🔒 安全最佳实践

1. 使用子用户凭证

❌ 不要使用主账号密钥：

SECRET_ID = "AKID 主账号密钥"  # 危险！

✅ 使用子用户密钥：

from dotenv import load_dotenv
load_dotenv('config/.env')
SECRET_ID = os.getenv('TENCENT_SECRET_ID')

2. 最小权限原则

只授予必要的权限：

• 开发环境：只读权限 + 创建权限
• 生产环境：只读权限 + 启停权限
• 避免：财务权限、用户管理权限

3. 定期轮换密钥

每 90 天轮换一次密钥。

4. 启用操作审计

tcm = TencentCloudManager(enable_audit=True)

📈 运维管理

日常巡检

# 检查所有实例状态
instances = tcm.list_all_instances()
for inst in instances:
    status = tcm.get_resource_status(inst['service'], inst['id'])
    if status['state'] != 'RUNNING':
        print(f"⚠️  实例异常：{inst['name']}")

# 检查即将到期的资源
expiring = tcm.get_expiring_resources(days=30)
for resource in expiring:
    print(f"⏰ 即将到期：{resource['name']}")

📚 相关文档

• CVM API 文档
• Lighthouse API 文档
• COS API 文档
• 子用户权限配置

🆘 故障排除

问题 1: 凭证验证失败

cat config/.env
python3 src/verify_config.py

问题 2: 权限不足

tccli cam ListAttachedUserPolicies --AttachUin <UIN>

问题 3: 创建失败

tccli cvm DescribeAccountQuota