阿里云 SDK & API 说明

安装 Python SDK

创建 Python 虚拟环境并安装 SDK：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --index-url https://pypi.org/simple "alibabacloud-sandbox20260820==1.2.0"

安装命令使用官方 PyPI（Python Package Index，Python 包索引）源，以便获取已发布的版本。使用其他镜像源时，需确认所需版本已经同步。Python 导入模块名为 alibabacloud_sandbox20260820。

配置凭证与地域

在运行环境中设置凭证、地域和接入点。以下以杭州地域为例，使用其他地域时，同时修改地域和接入点：

export ALIBABA_CLOUD_ACCESS_KEY_ID="<YOUR-ACCESSKEY-ID>"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<YOUR-ACCESSKEY-SECRET>"
# 使用 STS 临时凭证时，还需设置对应的 SecurityToken：
# export ALIBABA_CLOUD_SECURITY_TOKEN="<YOUR-SECURITY-TOKEN>"

export SANDBOX_REGION_ID="cn-hangzhou"
export SANDBOX_ENDPOINT="sandbox.cn-hangzhou.aliyuncs.com"

STS 临时凭证中的 AccessKey ID、AccessKey Secret 和 SecurityToken 需要配套使用，并在有效期内调用。

初始化客户端并调用接口

以下示例使用 ListTeams 查询第一页 Team。调用身份需要具备该接口的调用权限。将代码保存为 list_teams.py：

import json
import os

from alibabacloud_sandbox20260820 import models
from alibabacloud_sandbox20260820.client import Client as SandboxClient
from alibabacloud_tea_openapi import utils_models as open_api_models


def require_env(name: str) -> str:
    value = os.environ.get(name, "").strip()
    if not value:
        raise RuntimeError(f"缺少环境变量: {name}")
    return value


config = open_api_models.Config(
    access_key_id=require_env("ALIBABA_CLOUD_ACCESS_KEY_ID"),
    access_key_secret=require_env("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
    security_token=os.environ.get("ALIBABA_CLOUD_SECURITY_TOKEN"),
    region_id=require_env("SANDBOX_REGION_ID"),
    endpoint=require_env("SANDBOX_ENDPOINT"),
)
client = SandboxClient(config)

response = client.list_teams(
    models.ListTeamsRequest(page_number=1, page_size=10)
)
if response.body is None:
    raise RuntimeError("ListTeams 未返回响应内容")

print(json.dumps(response.body.to_map(), ensure_ascii=False, indent=2))

运行示例：

python list_teams.py

响应中包含当前页的 Team 列表、总数和请求 ID。该示例只查询第一页，需要继续获取时，按响应中的分页信息调整 page_number。

调用其他接口时，可复用上述客户端初始化方式，再按相应操作文档设置请求模型和参数。具体接口使用哪些字段，以当前 API 版本的文档和 SDK 模型为准。