yicloud-sdk-python 0.1.0__py3-none-any.whl

yicloud/services/modelset/__init__.py

@@ -0,0 +1,45 @@
+from yicloud.services.modelset.client import ModelSetClient as Client, client, use_client
+from . import actions, models
+
+from .actions import (
+    create_model_set,
+    list_model_set,
+    get_model_set,
+    update_model_set,
+    delete_model_set,
+    scale_model_set,
+    stop_model_set,
+    start_model_set,
+    list_model_set_replica,
+)
+from .models import (
+    EnvironmentVar,
+    PortConfig,
+    InstanceType,
+    RollingUpdateConfig,
+    GPFSMount,
+    HTTPHeader,
+    HTTPProbe,
+    TCPSocketProbe,
+    ExecProbe,
+    ProbeConfig,
+    ModelConfig,
+    AutoScalingTriggerCron,
+    AutoScalingTriggerMetrics,
+    AutoScalingPolicy,
+    AutoScalingRule,
+    AutoScalingConfig,
+    CreateModelSetRequest,
+    UpdateModelSetRequest,
+    ScaleModelSetRequest,
+    DeleteModelSetRequest,
+    StopModelSetRequest,
+    StartModelSetRequest,
+    ModelSetDetail,
+    ModelSetReplica,
+    ListModelSetRequest,
+    GetModelSetRequest,
+    ListModelSetReplicaRequest,
+    ListModelSetData,
+    ListModelSetReplicaData,
+)

yicloud/services/modelset/actions.py

@@ -0,0 +1,130 @@
+from typing import Optional
+from yicloud.base import msgs
+from yicloud.services.modelset import models
+from yicloud.services.modelset.client import client
+
+_PRODUCT_CODE = "modelset"
+_LAST_VERSION = "v1alpha1"
+
+
+def create_model_set(ctx: Optional[dict], req: models.CreateModelSetRequest) -> models.ModelSetDetail:
+    """
+    POST /modelset/v1alpha1/CreateModelSet
+    Action: CreateModelSet
+
+    Returns ModelSetDetail on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/CreateModelSet"
+    rsp = msgs.Rsp[models.ModelSetDetail]()
+    client.base.post(ctx, path, req.__dict__, rsp)
+    return rsp.get_typed_data()
+
+
+def list_model_set(ctx: Optional[dict], req: models.ListModelSetRequest) -> models.ListModelSetData:
+    """
+    GET /modelset/v1alpha1/ListModelSet
+    Action: ListModelSet
+
+    Returns ListModelSetData on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListModelSet"
+    rsp = msgs.Rsp[models.ListModelSetData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+def get_model_set(ctx: Optional[dict], req: models.GetModelSetRequest) -> models.ModelSetDetail:
+    """
+    GET /modelset/v1alpha1/GetModelSet
+    Action: GetModelSet
+
+    Returns ModelSetDetail on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetModelSet"
+    rsp = msgs.Rsp[models.ModelSetDetail]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+def update_model_set(ctx: Optional[dict], req: models.UpdateModelSetRequest) -> models.ModelSetDetail:
+    """
+    POST /modelset/v1alpha1/UpdateModelSet
+    Action: UpdateModelSet
+
+    Returns ModelSetDetail on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/UpdateModelSet"
+    rsp = msgs.Rsp[models.ModelSetDetail]()
+    client.base.post(ctx, path, req.__dict__, rsp)
+    return rsp.get_typed_data()
+
+
+def delete_model_set(ctx: Optional[dict], req: models.DeleteModelSetRequest) -> None:
+    """
+    POST /modelset/v1alpha1/DeleteModelSet
+    Action: DeleteModelSet
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/DeleteModelSet"
+    rsp = msgs.Rsp[None].empty()
+    client.base.post(ctx, path, req.__dict__, rsp)
+
+
+def scale_model_set(ctx: Optional[dict], req: models.ScaleModelSetRequest) -> None:
+    """
+    POST /modelset/v1alpha1/ScaleModelSet
+    Action: ScaleModelSet
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ScaleModelSet"
+    rsp = msgs.Rsp[None].empty()
+    client.base.post(ctx, path, req.__dict__, rsp)
+
+
+def stop_model_set(ctx: Optional[dict], req: models.StopModelSetRequest) -> None:
+    """
+    POST /modelset/v1alpha1/StopModelSet
+    Action: StopModelSet
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/StopModelSet"
+    rsp = msgs.Rsp[None].empty()
+    client.base.post(ctx, path, req.__dict__, rsp)
+
+
+def start_model_set(ctx: Optional[dict], req: models.StartModelSetRequest) -> None:
+    """
+    POST /modelset/v1alpha1/StartModelSet
+    Action: StartModelSet
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/StartModelSet"
+    rsp = msgs.Rsp[None].empty()
+    client.base.post(ctx, path, req.__dict__, rsp)
+
+
+def list_model_set_replica(ctx: Optional[dict], req: models.ListModelSetReplicaRequest) -> models.ListModelSetReplicaData:
+    """
+    GET /modelset/v1alpha1/ListModelSetReplica
+    Action: ListModelSetReplica
+
+    Returns ListModelSetReplicaData on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListModelSetReplica"
+    rsp = msgs.Rsp[models.ListModelSetReplicaData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()

yicloud/services/modelset/client.py

@@ -0,0 +1,19 @@
+from yicloud.base import Client
+
+
+class ModelSetClient:
+    """ModelSet service client, matching Go SDK's services/modelset/client.go."""
+
+    def __init__(self, base_client: Client = None):
+        self.base = base_client
+        self.product_code = "modelset"
+        self.last_version = "v1alpha1"
+
+
+# Singleton matching Go SDK
+client: ModelSetClient = ModelSetClient()
+
+
+def use_client(cli: Client) -> None:
+    """Set the base client for ModelSet service."""
+    client.base = cli

yicloud/services/modelset/models.py

@@ -0,0 +1,356 @@
+# Code generated from Go SDK's services/modelset/models.go. DO NOT EDIT.
+
+from dataclasses import dataclass, field
+from typing import Optional, List, Dict
+
+
+# Environment variables, ports, and instance types
+@dataclass
+class EnvironmentVar:
+    Key: str  # json:"Key"
+    Value: str  # json:"Value"
+
+
+@dataclass
+class PortConfig:
+    ContainerPort: int  # json:"ContainerPort"
+    HostPort: int  # json:"HostPort"
+    Type: str  # json:"Type"
+    Path: str  # json:"Path"
+
+
+@dataclass
+class InstanceType:
+    GpuCount: int  # json:"GpuCount" # cores
+    CpuCount: int  # json:"CpuCount" # cards
+    Memory: int  # json:"Memory" # Gi
+    GpuType: str  # json:"GpuType"
+
+
+@dataclass
+class RollingUpdateConfig:
+    MaxSurge: Optional[int] = None  # json:"MaxSurge,omitempty" # 0~100
+    MaxUnavailable: Optional[int] = None  # json:"MaxUnavailable,omitempty" # 0~100
+
+
+@dataclass
+class GPFSMount:
+    SourceAddress: str  # json:"SourceAddress"
+    MountPoint: str  # json:"MountPoint"
+
+
+# Probes and health check configuration
+@dataclass
+class HTTPHeader:
+    Key: str  # json:"Key"
+    Value: str  # json:"Value"
+
+
+@dataclass
+class HTTPProbe:
+    Scheme: str  # json:"Scheme" # http or https
+    HTTPHeaders: Optional[List[HTTPHeader]] = None  # json:"HTTPHeaders,omitempty"
+    Path: str = ""  # json:"Path"
+    Port: str = ""  # json:"Port"
+
+
+@dataclass
+class TCPSocketProbe:
+    Port: str  # json:"Port"
+
+
+@dataclass
+class ExecProbe:
+    Command: List[str] = field(default_factory=list)  # json:"Command"
+
+
+@dataclass
+class ProbeConfig:
+    Enabled: bool  # json:"Enabled" # switch
+
+    # Three check methods, choose one
+    HTTPGet: Optional[HTTPProbe] = None  # json:"HTTPGet,omitempty"
+    TCPSocket: Optional[TCPSocketProbe] = None  # json:"TCPSocket,omitempty"
+    ExecProbe: Optional[ExecProbe] = None  # json:"Exec,omitempty"
+
+    # Time settings
+    InitialDelaySeconds: int = 0  # json:"InitialDelaySeconds"
+    TimeoutSeconds: int = 0  # json:"TimeoutSeconds"
+    PeriodSeconds: int = 0  # json:"PeriodSeconds"
+
+    # Thresholds
+    SuccessThreshold: int = 0  # json:"SuccessThreshold"
+    FailureThreshold: int = 0  # json:"FailureThreshold"
+
+
+@dataclass
+class ModelConfig:
+    Name: str  # json:"Name"
+    Version: str  # json:"Version"
+    Namespace: str  # json:"Namespace"
+
+
+@dataclass
+class AutoScalingTriggerCron:
+    Start: str  # json:"Start" # a cron string for start
+    End: str  # json:"End" # a cron string for end
+    DesiredReplicas: str  # json:"DesiredReplicas" # a string format integer
+
+
+@dataclass
+class AutoScalingTriggerMetrics:
+    Type: str  # json:"Type" # valid: gpu_utilization, cpu_utilization, memory_utilization, sm_activity, active_instance_ratio, per_instance_load
+    Threshold: str  # json:"Threshold" # a string format metric value
+
+
+@dataclass
+class AutoScalingPolicy:
+    Type: str  # json:"Type" # valid values: Pods, Percent
+    Value: int  # json:"Value" # percent num greater than 0 and eql 100
+    PeriodSeconds: int  # json:"PeriodSeconds" # greater than zero and less than or equal to 1800
+
+
+@dataclass
+class AutoScalingRule:
+    # StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour).
+    # default value: up: 0; down 300
+    StabilizationWindowSeconds: Optional[int] = None  # json:"StabilizationWindowSeconds,omitempty"
+    Policies: Optional[List[AutoScalingPolicy]] = None  # json:"Policies,omitempty"
+    SelectPolicy: Optional[str] = None  # json:"SelectPolicy,omitempty"
+
+
+@dataclass
+class AutoScalingConfig:
+    Enabled: bool  # json:"Enabled"
+    MinReplicaCount: Optional[int] = None  # json:"MinReplicaCount,omitempty"
+    MaxReplicaCount: Optional[int] = None  # json:"MaxReplicaCount,omitempty"
+    CronTriggerList: Optional[List[AutoScalingTriggerCron]] = None  # json:"CronTriggerList,omitempty"
+    MetricsTriggerList: Optional[List[AutoScalingTriggerMetrics]] = None  # json:"MetricsTriggerList,omitempty"
+
+    ScaleUp: Optional[AutoScalingRule] = None  # json:"ScaleUp,omitempty"
+    ScaleDown: Optional[AutoScalingRule] = None  # json:"ScaleDown,omitempty"
+
+
+# Request models
+@dataclass
+class CreateModelSetRequest:
+    Project: str  # json:"Project" # project identifier
+
+    CreatorName: str  # json:"CreatorName"
+    CreatorId: str  # json:"CreatorId"
+    CreatorDepartment: str  # json:"CreatorDepartment"
+    CreatorType: str  # json:"CreatorType"
+    PrivateMachine: str  # json:"PrivateMachine"
+
+    # Basic info
+    Name: str  # json:"Name"
+    Description: Optional[str] = None  # json:"Description,omitempty"
+    QuotaGroup: str = ""  # json:"QuotaGroup"
+    IsCPUQuotaGroup: bool = False  # json:"IsCPUQuotaGroup"
+    QuotaGroupAllocateScope: str = ""  # json:"QuotaGroupAllocateScope"
+    IsInference: bool = False  # json:"IsInference"
+
+    IsIdle: bool = False  # json:"IsIdle"
+
+    # Environment configuration
+    Image: str = ""  # json:"Image"
+    Command: List[str] = field(default_factory=list)  # json:"Command"
+    EnvVars: Optional[List[EnvironmentVar]] = None  # json:"EnvVars,omitempty"
+
+    # Instance configuration
+    Distributed: Optional[bool] = None  # json:"Distributed,omitempty" # whether distributed inference is enabled
+    InstanceCount: Optional[int] = None  # json:"InstanceCount,omitempty" # instance count, effective when distributed inference is enabled, otherwise defaults to 1
+
+    InstanceType: Optional[InstanceType] = None  # json:"InstanceType"
+    Replicas: int = 0  # json:"Replicas" # replica count
+    RollingUpdate: Optional[RollingUpdateConfig] = None  # json:"RollingUpdate,omitempty"
+    GpfsMounts: Optional[List[GPFSMount]] = None  # json:"GPFSMounts,omitempty"
+
+    # Port configuration (max 5)
+    Ports: List[PortConfig] = field(default_factory=list)  # json:"Ports"
+
+    # Health check
+    LivenessProbe: Optional[ProbeConfig] = None  # json:"LivenessProbe,omitempty"
+    ReadinessProbe: Optional[ProbeConfig] = None  # json:"ReadinessProbe,omitempty"
+    StartupProbe: Optional[ProbeConfig] = None  # json:"StartupProbe,omitempty"
+
+    # Auto-scaling configuration
+    AutoScalingConfig: Optional[AutoScalingConfig] = None  # json:"AutoScalingConfig,omitempty"
+
+
+@dataclass
+class UpdateModelSetRequest:
+    # Identification info
+    Project: str  # json:"Project"
+    Id: str  # json:"Id"
+
+    # Basic info
+    Name: Optional[str] = None  # json:"Name,omitempty" # optional
+    Description: Optional[str] = None  # json:"Description,omitempty" # optional
+    QuotaGroup: Optional[str] = None  # json:"QuotaGroup,omitempty"
+
+    IsInference: Optional[bool] = None  # json:"IsInference,omitempty"
+
+    # Environment configuration
+    Image: Optional[str] = None  # json:"Image,omitempty" # replace entire image config
+    Command: Optional[List[str]] = None  # json:"Command,omitempty" # replace entire command
+    EnvVars: Optional[List[EnvironmentVar]] = None  # json:"EnvVars,omitempty" # replace all environment variables
+
+    # Instance configuration
+    Distributed: Optional[bool] = None  # json:"Distributed,omitempty" # whether distributed inference is enabled
+    InstanceCount: Optional[int] = None  # json:"InstanceCount,omitempty" # instance count, effective when distributed inference is enabled
+
+    InstanceType: Optional[InstanceType] = None  # json:"InstanceType,omitempty"
+    Replicas: Optional[int] = None  # json:"Replicas,omitempty"
+    RollingUpdate: Optional[RollingUpdateConfig] = None  # json:"RollingUpdate,omitempty"
+    GpfsMounts: Optional[List[GPFSMount]] = None  # json:"GPFSMounts,omitempty" # replace all mounts
+
+    # Port configuration (max 5)
+    Ports: Optional[List[PortConfig]] = None  # json:"Ports,omitempty" # replace all ports
+
+    # Health check (can be updated separately)
+    LivenessProbe: Optional[ProbeConfig] = None  # json:"LivenessProbe,omitempty"
+    ReadinessProbe: Optional[ProbeConfig] = None  # json:"ReadinessProbe,omitempty"
+    StartupProbe: Optional[ProbeConfig] = None  # json:"StartupProbe,omitempty"
+
+    # Auto-scaling configuration
+    AutoScalingConfig: Optional[AutoScalingConfig] = None  # json:"AutoScalingConfig,omitempty"
+
+    # Model configuration
+    Model: Optional[ModelConfig] = None  # json:"Model,omitempty"
+
+
+@dataclass
+class ScaleModelSetRequest:
+    Project: str  # json:"Project"
+    Id: str  # json:"Id"
+    Replicas: int  # json:"Replicas"
+
+
+@dataclass
+class DeleteModelSetRequest:
+    Project: str  # json:"Project"
+    Id: str  # json:"Id"
+
+
+@dataclass
+class StopModelSetRequest:
+    Project: str  # json:"Project"
+    Id: str  # json:"Id"
+
+
+@dataclass
+class StartModelSetRequest:
+    Project: str  # json:"Project"
+    Id: str  # json:"Id"
+
+
+# Response models
+@dataclass
+class ModelSetDetail:
+    Id: str  # json:"Id"
+    UId: str  # json:"UId"
+    Status: str  # json:"Status" # e.g., "Running", "Failed", "Updating"
+    ReadyReplicas: int  # json:"ReadyReplicas"
+    TotalReplicas: int  # json:"TotalReplicas"
+    Creator: str  # json:"Creator"
+    CreatorId: str  # json:"CreatorId"
+
+    # Basic info
+    Name: str  # json:"Name"
+    Description: Optional[str] = None  # json:"Description,omitempty"
+    QuotaGroup: str = ""  # json:"QuotaGroup"
+
+    IsCPUQuotaGroup: bool = False  # json:"IsCPUQuotaGroup"
+    QuotaGroupAllocateScope: str = ""  # json:"QuotaGroupAllocateScope"
+
+    IsInference: bool = False  # json:"IsInference"
+    IsIdle: bool = False  # json:"IsIdle"
+
+    # Environment configuration
+    Image: str = ""  # json:"Image"
+    Command: List[str] = field(default_factory=list)  # json:"Command"
+    EnvVars: Optional[List[EnvironmentVar]] = None  # json:"EnvVars,omitempty"
+
+    # Instance configuration
+    Distributed: bool = False  # json:"Distributed" # whether distributed inference is enabled
+    InstanceCount: int = 0  # json:"InstanceCount" # instance count, effective when distributed inference is enabled
+    InstanceType: Optional[InstanceType] = None  # json:"InstanceType"
+    Replicas: int = 0  # json:"Replicas" # replica count
+    RollingUpdate: Optional[RollingUpdateConfig] = None  # json:"RollingUpdate,omitempty"
+    GpfsMounts: Optional[List[GPFSMount]] = None  # json:"GPFSMounts,omitempty"
+
+    # Port configuration
+    Ports: List[PortConfig] = field(default_factory=list)  # json:"Ports"
+
+    # Health check
+    LivenessProbe: Optional[ProbeConfig] = None  # json:"LivenessProbe,omitempty"
+    ReadinessProbe: Optional[ProbeConfig] = None  # json:"ReadinessProbe,omitempty"
+    StartupProbe: Optional[ProbeConfig] = None  # json:"StartupProbe,omitempty"
+
+    CreationTimestamp: int = 0  # json:"CreationTimestamp" # milliseconds
+
+    # Only appears in return values, for chat
+    ServeName: str = ""  # json:"ServeName"
+    PublicDomain: str = ""  # json:"PublicDomain"
+    PublicIP: str = ""  # json:"PublicIP"
+    ClusterDomain: str = ""  # json:"ClusterDomain"
+    ClusterIP: str = ""  # json:"ClusterIP"
+    APIKey: str = ""  # json:"APIKey"
+    ServePorts: List[PortConfig] = field(default_factory=list)  # json:"ServePorts"
+
+    AutoScalingConfig: Optional[AutoScalingConfig] = None  # json:"AutoScalingConfig,omitempty"
+
+    # Model configuration
+    Model: Optional[ModelConfig] = None  # json:"Model,omitempty"
+
+
+@dataclass
+class ModelSetReplica:
+    Id: str  # json:"Id"
+    Status: str  # json:"Status"
+    IP: str  # json:"IP"
+    CreationTime: int  # json:"CreationTime" # seconds
+    LatestCondition: str = ""  # json:"LatestCondition"
+
+
+# GET request models
+@dataclass
+class ListModelSetRequest:
+    Project: str  # query:"Project" binding:"required"
+    Limit: int = 10  # query:"Limit" binding:"omitempty"
+    Offset: int = 0  # query:"Offset" binding:"omitempty"
+    SortBy: str = ""  # query:"SortBy" binding:"omitempty"
+    SortDirection: str = ""  # query:"SortDirection" binding:"omitempty"
+    Keyword: str = ""  # query:"Keyword" binding:"omitempty"
+    Status: str = ""  # query:"Status" binding:"omitempty"
+    LatestCondition: str = ""  # query:"LatestCondition" binding:"omitempty"
+
+
+@dataclass
+class GetModelSetRequest:
+    Project: str  # query:"Project" binding:"required"
+    Id: str  # query:"Id" binding:"required"
+
+
+@dataclass
+class ListModelSetReplicaRequest:
+    Project: str  # query:"Project" binding:"required"
+    Id: str  # query:"Id" binding:"required"
+
+
+# List response models
+@dataclass
+class ListModelSetData:
+    Data: List[ModelSetDetail] = field(default_factory=list)  # json:"Data"
+    Total: int = 0  # json:"Total"
+    Limit: int = 10  # json:"Limit"
+    Offset: int = 0  # json:"Offset"
+
+
+@dataclass
+class ListModelSetReplicaData:
+    Items: List[ModelSetReplica] = field(default_factory=list)  # json:"Items"
+    Total: int = 0  # json:"Total"
+    Limit: int = 10  # json:"Limit"
+    Offset: int = 0  # json:"Offset"

yicloud/services/oss/__init__.py

@@ -0,0 +1,25 @@
+from yicloud.services.oss.client import OssClient as Client, client, use_client
+from . import actions, models
+
+from .actions import (
+    create_bucket,
+    delete_bucket,
+    update_bucket,
+    list_buckets,
+    get_bucket,
+)
+from .models import (
+    AuthType,
+    AuthMode,
+    State,
+    Auth,
+    Authorization,
+    CreateBucketRequest,
+    DeleteBucketRequest,
+    ListBucketsRequest,
+    UpdateBucketRequest,
+    GetBucketRequest,
+    MessageResponse,
+    BucketResponse,
+    ListBucketsResponse,
+)

yicloud/services/oss/actions.py

@@ -0,0 +1,83 @@
+from typing import Optional
+
+from yicloud.base import msgs
+from yicloud.services.oss import models
+from yicloud.services.oss.client import client
+
+_PRODUCT_CODE = "oss"
+_LAST_VERSION = "v1alpha1"
+
+
+def create_bucket(ctx: Optional[dict], req: models.CreateBucketRequest) -> models.MessageResponse:
+    """
+    POST /oss/v1alpha1/CreateBucket
+    Action: CreateBucket
+
+    Returns MessageResponse on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/CreateBucket"
+    rsp = msgs.Rsp[models.MessageResponse]()
+    client.base.post(ctx, path, req.__dict__, rsp)
+    return rsp.get_typed_data()
+
+
+def delete_bucket(ctx: Optional[dict], req: models.DeleteBucketRequest) -> models.MessageResponse:
+    """
+    POST /oss/v1alpha1/DeleteBucket
+    Action: DeleteBucket
+
+    Returns MessageResponse on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/DeleteBucket"
+    rsp = msgs.Rsp[models.MessageResponse]()
+    client.base.post(ctx, path, req.__dict__, rsp)
+    return rsp.get_typed_data()
+
+
+def update_bucket(ctx: Optional[dict], req: models.UpdateBucketRequest) -> models.MessageResponse:
+    """
+    POST /oss/v1alpha1/UpdateBucket
+    Action: UpdateBucket
+
+    Returns MessageResponse on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/UpdateBucket"
+    rsp = msgs.Rsp[models.MessageResponse]()
+    client.base.post(ctx, path, req.__dict__, rsp)
+    return rsp.get_typed_data()
+
+
+def list_buckets(ctx: Optional[dict], req: models.ListBucketsRequest) -> models.ListBucketsResponse:
+    """
+    GET /oss/v1alpha1/ListBuckets
+    Action: ListBuckets
+
+    Returns ListBucketsResponse on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListBuckets"
+    rsp = msgs.Rsp[models.ListBucketsResponse]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+def get_bucket(ctx: Optional[dict], req: models.GetBucketRequest) -> models.BucketResponse:
+    """
+    GET /oss/v1alpha1/GetBucket
+    Action: GetBucket
+
+    Returns BucketResponse on success.
+
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetBucket"
+    rsp = msgs.Rsp[models.BucketResponse]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()

yicloud/services/oss/client.py

@@ -0,0 +1,19 @@
+from yicloud.base import Client
+
+
+class OssClient:
+    """OSS service client, matching Go SDK's services/oss/client.go."""
+
+    def __init__(self, base_client: Client = None):
+        self.base = base_client
+        self.product_code = "oss"
+        self.last_version = "v1alpha1"
+
+
+# Singleton matching Go SDK
+client: OssClient = OssClient()
+
+
+def use_client(cli: Client) -> None:
+    """Set the base client for OSS service."""
+    client.base = cli