yicloud-sdk-python 0.1.0

YiCloud OpenAPI SDK for Python

OpenAPI SDK for Python

A Python SDK for the OpenAPI service.

Installation

使用 pip 安装（推荐）:

pip install yicloud-sdk-python

从源码安装（不推荐）： git clone https://gitee.com/yicloud-team/openapi-sdk-python.git cd openapi-sdk-python pip install -e .

Configuration

The SDK reads configuration from environment variables:

Variable	Default	Description
YICLOUD_API_HOST	https://gate.yicloud.com	API endpoint
YICLOUD_TIMEOUT	30	Timeout in seconds
YICLOUD_MAX_RETRIES	0	Max retry attempts
YICLOUD_PUBLIC_KEY	-	Access key (required)
YICLOUD_SECRET_KEY	-	Secret key (required)

Usage

import yicloud.base as base
from yicloud.services import iam
from yicloud.base import msgs

# Create config (reads from env vars)
cfg = base.new_config()
cfg.log_level = base.log.Level.DEBUG
cfg.timeout = 10

# Create credential (reads from env vars)
credential = base.new_credential()

# Create client
client = base.new_client(
    base.with_config(cfg),
    base.with_credential(credential),
)

# Inject client into service
iam.use_client(client)

# Create metadata context
ctx, meta = msgs.new_meta_ctx()

# Call API
try:
    user_data = iam.get_user(ctx, iam.GetUserReq(UserName="admin"))
    print(f"成功返回: {user_data}, RequestID={meta.request_id}")
except base.exc.ServerException as e:
    print(f"后端错误: action={e.action}, code={e.code}, message={e.message}")
except base.exc.ClientException as e:
    print(f"客户端错误: action={e.action}")
except base.exc.YiCloudException as e:
    print(f"SDK 错误: {e}")

Services

Service	Package	Actions	Description
IAM	yicloud.services.iam	22	User, AccessKey, Project, QuotaGroup management
Job	yicloud.services.job	11	Job lifecycle, logs, replicas
MC	yicloud.services.mc	16	Node, SKU, Project, QuotaGroup management
FS	yicloud.services.fs	7	Fileset, directory operations
OSS	yicloud.services.oss	5	Bucket CRUD
Registry	yicloud.services.registry	14	Image and repository management
ModelRepo	yicloud.services.modelrepo	11	Model and version management
ModelSet	yicloud.services.modelset	9	ModelSet lifecycle and scaling
BC	yicloud.services.bc	1	Billing details

Project Structure

yicloud/                    # Main package
├── base/                   # Infrastructure
│   ├── client.py           # HTTP client (Get/Post)
│   ├── config.py           # Configuration
│   ├── exc.py              # Exception types
│   ├── auth/               # HMAC-SHA256 signing
│   ├── log/                # Logger
│   ├── msgs/               # Response types (Rsp[T], Header, RspMeta)
│   └── utils/              # Utilities
└── services/               # Business services (9 services)
    ├── iam/                # Identity & Access Management
    ├── job/                # Job management
    ├── mc/                 # Multi-cluster management
    ├── fs/                 # Filesystem management
    ├── oss/                # Object storage
    ├── registry/           # Container registry
    ├── modelrepo/          # Model repository
    ├── modelset/           # ModelSet lifecycle
    └── bc/                 # Billing center
examples/                   # Example code (one per service)