使用 Python 调用云 API 实现批量共享自定义镜像
本文介绍如何通过 Python SDK 调用 API 接口,通过子用户批量共享云服务器自定义镜像。若您具备类似需求,或想了解如何使用 SDK,可参考本文进行操作。
前提条件
已创建子用户,并已具备云服务器及云 API 所有权限。
创建子用户请参见 新建子用户。
为子用户授予权限请参见 子用户权限设置,本文为子用户授予 QcloudCVMFullAccess
及 QcloudAPIFullAccess
预设策略。
为子用户创建 SecretId 与 SecretKey,操作步骤请参见 子账号访问密钥管理。请记录并妥善保管。
已具备待共享自定义镜像。如需创建,请参见 创建自定义镜像。
操作步骤
安装 Python
1. 执行以下命令查看当前云服务器是否已经安装 Python 3.6+版本,若已安装,则可以跳过安装步骤。
python --version
2. 若您的云服务器没有安装 Python。
CentOS 操作系统的云服务器可以执行以下命令安装。
yum install python3
Ubuntu/Debian 操作系统的云服务器可以执行以下命令安装。
sudo apt install python3
其他操作系统您可以前往 Python 官网,下载 Python 3.6+版本并上传至 Linux 服务器中,解压并安装 Python。
3. 安装完成后,请执行以下命令核实 Python 版本。
python --version
创建代码
1. 在调用机器上新建 test.py
文件,并输入以下代码。
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.cvm.v20170312 import cvm_client, models
# 默认读取环境变量 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
cred = credential.EnvironmentVariableCredential().get_credential()
httpProfile = HttpProfile()
httpProfile.endpoint = "cvm.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
# 举例为南京 请按实际情况进行修改 例如上海请修改为ap-shanghai
aria = 'ap-nanjing'
client = cvm_client.CvmClient(cred,aria, clientProfile)
def img_share(img_id,img_name,accountids):
try:
req1 = models.ModifyImageSharePermissionRequest()
params1 = {
"ImageId": img_id,
"AccountIds": accountids,
"Permission": "SHARE"
}
req1.from_json_string(json.dumps(params1))
resp1 = client.ModifyImageSharePermission(req1)
response1 = json.loads(resp1.to_json_string())
print(img_name,'共享成功!',response1)
except TencentCloudSDKException as err:
print(img_name,'共享失败!',err)
try:
req = models.DescribeImagesRequest()
params = {
"Filters": [
{
"Name": "image-type",
"Values": ["PRIVATE_IMAGE"]
}
],
"Limit": 100
}
req.from_json_string(json.dumps(params))
resp = client.DescribeImages(req)
response = json.loads(resp.to_json_string())
img_num = response["TotalCount"]
print('正在获取镜像列表....')
share_config = input('1.共享所有镜像\n\n2.让我决定每一个镜像\n\n输入1或2并按回车 默认为2:') or '2'
accountids = input('请输入被共享人uin 多个以英文逗号隔开:').split(",")
for i in range(img_num):
basic = response['ImageSet'][i]
img_id = basic['ImageId']
img_name = basic['ImageName']
if share_config == '1':
img_share(img_id,img_name,accountids)
elif share_config == '2':
print('镜像id:',img_id,'镜像名称:',img_name)
share_choice = input('是否共享此镜像 y/n:') or 'y'
if share_choice == 'y':
img_share(img_id,img_name,accountids)
elif share_choice == 'n':
continue
else:
print('请输入正确的选项!!')
else:
print('请输入正确的选项!!')
except TencentCloudSDKException as err:
print(err)
SecretId 与 SecretKey:请替换为已在 前提条件 中创建的子用户 SecretId 与 SecretKey。
aria:请替换为待共享自定义镜像实际所在地域。地域列表可参见 地域列表。
2. 在调用机器的命令行中执行以下命令,运行代码。
python test.py
根据屏幕提示输入1或2,同时共享所有镜像或依次选择共享镜像,并输入对端账号 ID。您可通知对方前往 账号信息 页面获取。 共享成功后,将返回对应数量的 RequestID。如下图所示: