yicloud-sdk-python 0.2.0__tar.gz → 0.3.0__tar.gz

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yicloud-sdk-python
-Version: 0.2.0
+Version: 0.3.0
 Summary: YiCloud OpenAPI SDK for Python
 Author: YiCloud
 Project-URL: Homepage, https://gitee.com/yicloud-team/openapi-sdk-python

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "yicloud-sdk-python"
-version = "0.2.0"
+version = "0.3.0"
 description = "YiCloud OpenAPI SDK for Python"
 readme = "README.md"
 requires-python = ">=3.7"

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/version.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.0"
+__version__ = "0.3.0"
 
 
 def Version() -> str:

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/__init__.py

@@ -4,4 +4,4 @@ YiCloud Python SDK
 A Python SDK for the YiCloud OpenAPI service.
 """
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/base/msgs/__init__.py

@@ -1,5 +1,5 @@
 import contextvars
-from typing import Any, Dict, Generic, Optional, Tuple, TypeVar, Union, get_args, get_origin
+from typing import Any, Dict, Generic, Optional, Tuple, TypeVar, Union, get_args, get_origin, get_type_hints
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, fields, is_dataclass
 
@@ -60,7 +60,7 @@ def _dict_to_dataclass(target_type, data):
     if not is_dataclass(target_type) or not isinstance(data, dict):
         return data
 
-    field_types = {f.name: f.type for f in fields(target_type)}
+    field_types = get_type_hints(target_type)
 
     kwargs = {}
     for key, value in data.items():

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/services/fs/__init__.py

@@ -22,10 +22,12 @@ from .models import (
     Authorization,
     CreateFilesetWithQuotaReqAuthorization,
     UpdateFilesetReqAuthorization,
+    BucketResponse,
     CreateFilesetWithQuotaReq,
     DeleteFilesetReq,
     GetFileInfoData,
     GetFilesetData,
+    FilesetItem,
     ListDirData,
     ListFilesetsWithQuotaInfoData,
     SetFilesetQuotaReq,

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/services/fs/models.py

@@ -31,6 +31,20 @@ class UpdateFilesetReqAuthorization:
     Name: Optional[str] = None    # 授权名称  json:"Name,omitempty"
     Type: Optional[str] = None    # 授权类型  json:"Type,omitempty"
 
+@dataclass
+class BucketResponse:
+    Bucket: Optional[str] = ""    # 文件集名称  json:"Bucket,omitempty"
+    Capacity: Optional[str] = ""    # 文件集容量（字节）  json:"Capacity,omitempty"
+    Created: Optional[str] = ""    # 创建时间  json:"Created,omitempty"
+    DeletedTime: Optional[str] = ""    # 删除时间（回收站中显示）  json:"DeletedTime,omitempty"
+    Fs: Optional[str] = ""    # 文件系统  json:"Fs,omitempty"
+    FsCluster: Optional[str] = ""    # 文件系统集群  json:"FsCluster,omitempty"
+    Owner: Optional[str] = ""    # 文件集所有者  json:"Owner,omitempty"
+    Permission: Optional[str] = ""    # 文件集权限  json:"Permission,omitempty"
+    Size: Optional[str] = ""    # 已使用容量（字节）  json:"Size,omitempty"
+    State: Optional[str] = ""    # 文件集状态  json:"State,omitempty"
+    Tenant: Optional[str] = ""    # 租户信息  json:"Tenant,omitempty"
+
 @dataclass
 class CreateFilesetWithQuotaReq:
     Capacity: int    # 文件集容量，单位字节  json:"Capacity"
@@ -73,16 +87,21 @@ class GetFilesetData:
     Tenant: Optional[str] = ""    # 租户信息  json:"Tenant,omitempty"
     Used: Optional[str] = ""    # 已使用容量（字节）  json:"Used,omitempty"
 
+@dataclass
+class FilesetItem:
+    BucketResponse: Optional[BucketResponse] = None    # 文件集详情  json:"BucketResponse,omitempty"
+    ID: Optional[str] = ""    # 文件集ID  json:"ID,omitempty"
+
 @dataclass
 class ListDirData:
-    Items: Optional[List[GetFileInfoData]] = None    # 文件/目录列表  json:"Items,omitempty"
+    Files: Optional[List[GetFileInfoData]] = None    # 文件/目录列表  json:"Files,omitempty"
     Limit: Optional[int] = 0    # 每页大小  json:"Limit,omitempty"
     Offset: Optional[int] = 0    # 当前偏移量  json:"Offset,omitempty"
     Total: Optional[int] = 0    # 总文件/目录数  json:"Total,omitempty"
 
 @dataclass
 class ListFilesetsWithQuotaInfoData:
-    Items: Optional[List[GetFilesetData]] = None    # 文件集列表  json:"Items,omitempty"
+    Items: Optional[List[FilesetItem]] = None    # 文件集列表  json:"Items,omitempty"
     Total: Optional[int] = 0    # 总文件集数  json:"Total,omitempty"
 
 @dataclass
@@ -117,18 +136,18 @@ class GetFilesetReq:
 class ListDirReq:
     Path: str    # 目录路径  query:"Path"
     CalculateDirSize: Optional[bool] = None    # 是否计算目录大小  query:"CalculateDirSize,omitempty"
-    Offset: Optional[int] = None    # 偏移量，从第几条记录开始查询  query:"Offset,omitempty"
     Limit: Optional[int] = None    # 每页数量  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 偏移量，从第几条记录开始查询  query:"Offset,omitempty"
     SortBy: Optional[str] = None    # 排序字段  query:"SortBy,omitempty"
     SortOrder: Optional[str] = None    # 排序顺序  query:"SortOrder,omitempty"
 
 @dataclass
 class ListFilesetsWithQuotaInfoReq:
-    SortBy: Optional[str] = None    # 排序字段，格式：字段名:排序方向，如 created:desc  query:"SortBy,omitempty"
-    Offset: Optional[int] = None    # 偏移量，从第几条记录开始查询  query:"Offset,omitempty"
-    Limit: Optional[int] = None    # 每页数量  query:"Limit,omitempty"
     Fs: Optional[str] = None    # 文件系统，枚举值: GPFS SDK常量: FsGPFS  query:"Fs,omitempty"
     FsCluster: Optional[str] = None    # 文件系统集群，枚举值: gpfs1 SDK常量: FsClustergpfs1  query:"FsCluster,omitempty"
     Keyword: Optional[str] = None    # 关键字搜索  query:"Keyword,omitempty"
+    Limit: Optional[int] = None    # 每页数量  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 偏移量，从第几条记录开始查询  query:"Offset,omitempty"
     Owner: Optional[str] = None    # 所有者  query:"Owner,omitempty"
+    SortBy: Optional[str] = None    # 排序字段，格式：字段名:排序方向，如 created:desc  query:"SortBy,omitempty"
 

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/services/mc/models.py

@@ -96,12 +96,12 @@ class CreateProjectReq:
 
 @dataclass
 class CreateQuotaGroupReq:
-    MachineType: str    # SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType"
+    MachineType: str    # 机器类型（CPU/GPU） SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType"
     Project: str    # 项目名  json:"Project"
     QuotaGroup: str    # 配额组名  json:"QuotaGroup"
-    UsageType: str    # SDK常量: UsageTypeWorkspace, UsageTypeWorkload  json:"UsageType"
+    UsageType: str    # 使用类型（workspace/workload） SDK常量: UsageTypeWorkspace, UsageTypeWorkload  json:"UsageType"
     AllocateScope: Optional[str] = None    # 分配范围（可选，不传则自动推断） SDK常量: AllocateScopePublic, AllocateScopeTenant, AllocateScopeProject, AllocateScopeQuotagroup, AllocateNoValue  json:"AllocateScope,omitempty"
-    NodeNames: Optional[List[str]] = None    # json:"NodeNames,omitempty"
+    NodeNames: Optional[List[str]] = None    # 节点名称列表  json:"NodeNames,omitempty"
     Quota: Optional[CreateQuotaGroupReqQuota] = None    # 配额  json:"Quota,omitempty"
     QuotaGroupUsers: Optional[List[CreateQuotaGroupReqQuotaGroupUser]] = None    # 配额组角色列表（指针用于判断是否传参）  json:"QuotaGroupUsers,omitempty"
 
@@ -143,7 +143,7 @@ class ListNodeInstancesData:
 
 @dataclass
 class ListNodesData:
-    GpuOccupancyUsers: Optional[Dict[str, int]] = None    # json:"GpuOccupancyUsers,omitempty"
+    GpuOccupancyUsers: Optional[Dict[str, int]] = None    # GPU 占用用户统计（用户名 -> Pod 数）  json:"GpuOccupancyUsers,omitempty"
     Items: Optional[List[NodeData]] = None    # 节点列表  json:"Items,omitempty"
     Limit: Optional[int] = 0    # 分页大小  json:"Limit,omitempty"
     Offset: Optional[int] = 0    # 分页偏移量  json:"Offset,omitempty"
@@ -188,6 +188,8 @@ class ListQuotaGroupsSimpleData:
 @dataclass
 class ListSKUsData:
     Items: Optional[List[SKUData]] = None    # SKU列表  json:"Items,omitempty"
+    Limit: Optional[int] = 0    # 分页大小  json:"Limit,omitempty"
+    Offset: Optional[int] = 0    # 分页偏移量  json:"Offset,omitempty"
     Total: Optional[int] = 0    # 总条数  json:"Total,omitempty"
 
 @dataclass
@@ -205,13 +207,14 @@ class ListNodeConfigurationData:
 @dataclass
 class NodeData:
     GPUType: Optional[str] = ""    # 卡类型  json:"GPUType,omitempty"
-    MachineType: Optional[str] = None    # SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType,omitempty"
+    Internet: Optional[bool] = False    # 是否联网  json:"Internet,omitempty"
+    MachineType: Optional[str] = None    # 机器类型（CPU/GPU） SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType,omitempty"
     MaintenanceStatus: Optional[str] = ""    # 维护状态  json:"MaintenanceStatus,omitempty"
     NodeId: Optional[str] = ""    # 节点UID  json:"NodeId,omitempty"
     NodeName: Optional[str] = ""    # 基本信息  json:"NodeName,omitempty"
     NodeQuota: Optional[NodeQuota] = None    # 节点配额  json:"NodeQuota,omitempty"
     NodeStatus: Optional[str] = ""    # 状态信息  json:"NodeStatus,omitempty"
-    PodCount: Optional[int] = 0    # 系统信息  json:"PodCount,omitempty"
+    PodCount: Optional[int] = 0    # Pod个数  json:"PodCount,omitempty"
     Project: Optional[str] = ""    # 项目名称  json:"Project,omitempty"
     QuotaGroup: Optional[str] = ""    # 配额组  json:"QuotaGroup,omitempty"
     Unschedulable: Optional[bool] = False    # 不可调度  json:"Unschedulable,omitempty"
@@ -323,12 +326,12 @@ class UpdateQuotaGroupReqQuota:
 @dataclass
 class GetQuotaGroupData:
     AllocateScope: Optional[str] = None    # 分配范围：global_public / tenant_public / project_public / quotagroup_private SDK常量: AllocateScopePublic, AllocateScopeTenant, AllocateScopeProject, AllocateScopeQuotagroup, AllocateNoValue  json:"AllocateScope,omitempty"
-    CpuMemoryLimit: Optional[CpuMemoryLimit] = None    # json:"CpuMemoryLimit,omitempty"
+    CpuMemoryLimit: Optional[CpuMemoryLimit] = None    # CPU/内存限制  json:"CpuMemoryLimit,omitempty"
     CreationTime: Optional[str] = ""    # 创建时间（RFC3339，UTC）  json:"CreationTime,omitempty"
     Creator: Optional[str] = ""    # 创建者  json:"Creator,omitempty"
     IdleStatus: Optional[str] = None    # 闲时状态 SDK常量: IdleStatusOpen, IdleStatusClosed  json:"IdleStatus,omitempty"
-    MachineType: Optional[str] = None    # SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType,omitempty"
-    NodeNames: Optional[List[str]] = None    # json:"NodeNames,omitempty"
+    MachineType: Optional[str] = None    # 机器类型（CPU/GPU） SDK常量: MachineTypeCPU, MachineTypeGPU  json:"MachineType,omitempty"
+    NodeNames: Optional[List[str]] = None    # 节点名称列表  json:"NodeNames,omitempty"
     Project: Optional[str] = ""    # 项目名  json:"Project,omitempty"
     QuotaGroup: Optional[str] = ""    # 配额组名  json:"QuotaGroup,omitempty"
     QuotaGroupId: Optional[str] = ""    # 配额组ID  json:"QuotaGroupId,omitempty"
@@ -336,7 +339,7 @@ class GetQuotaGroupData:
     QuotaStatus: Optional[QuotaStatus] = None    # 配额状态  json:"QuotaStatus,omitempty"
     SchedStrategy: Optional[str] = None    # 调度策略 SDK常量: SchedStrategySoft, SchedStrategyStrict  json:"SchedStrategy,omitempty"
     TenantIdleStatus: Optional[str] = None    # 租户闲时状态 SDK常量: IdleStatusOpen, IdleStatusClosed  json:"TenantIdleStatus,omitempty"
-    UsageType: Optional[str] = None    # SDK常量: UsageTypeWorkspace, UsageTypeWorkload  json:"UsageType,omitempty"
+    UsageType: Optional[str] = None    # 使用类型（workspace/workload） SDK常量: UsageTypeWorkspace, UsageTypeWorkload  json:"UsageType,omitempty"
 
 @dataclass
 class QuotaGroupUser:
@@ -389,6 +392,7 @@ class SKUData:
     CpuCores: Optional[str] = ""    # CPU 核数  json:"CpuCores,omitempty"
     GpuCores: Optional[str] = ""    # GPU 核数  json:"GpuCores,omitempty"
     GpuMemBytes: Optional[str] = ""    # GPU 显存字节数  json:"GpuMemBytes,omitempty"
+    Internet: Optional[bool] = False    # 是否联网  json:"Internet,omitempty"
     MemBytes: Optional[str] = ""    # 内存字节数  json:"MemBytes,omitempty"
     SKUId: Optional[str] = ""    # SKU ID  json:"SKUId,omitempty"
     Vendor: Optional[str] = ""    # 厂商  json:"Vendor,omitempty"
@@ -437,6 +441,7 @@ class GetQuotaGroupReq:
 
 @dataclass
 class ListAuditLogsReq:
+    ResourceType: List[str]    # 资源类型，支持多个值。枚举：projects(项目), userbindings(用户权限), users(用户), public-dataset(公共数据集), public-codebase(公共Codebase), dataset(数据集), labeltask(标注任务), experiment(训练任务), run(训练实验), workspace(开发机), rjobs(RJob), model(模型), evalhub(评测任务), inference(推理服务), codebase(Codebase), images(镜像), oss(对象存储), quotagroups(配额组), tenants(租户), netpolicies(网络策略), replicas(副本), process(worker), cleanpolicies(清理策略)  query:"ResourceType"
     Limit: Optional[int] = None    # 每页数量  query:"Limit,omitempty"
     Offset: Optional[int] = None    # 偏移量  query:"Offset,omitempty"
     OperationType: Optional[str] = None    # 操作类型（如 create, update, delete 等）  query:"OperationType,omitempty"
@@ -444,17 +449,18 @@ class ListAuditLogsReq:
     Project: Optional[str] = None    # 项目名  query:"Project,omitempty"
     ProjectName: Optional[str] = None    # 项目名称（可选，用于模糊查询）  query:"ProjectName,omitempty"
     ResourceName: Optional[str] = None    # 资源名称（模糊搜索）  query:"ResourceName,omitempty"
-    ResourceType: List[str]    # 资源类型，支持多个值。枚举：projects(项目), userbindings(用户权限), users(用户), public-dataset(公共数据集), public-codebase(公共Codebase), dataset(数据集), labeltask(标注任务), experiment(训练任务), run(训练实验), workspace(开发机), rjobs(RJob), model(模型), evalhub(评测任务), inference(推理服务), codebase(Codebase), images(镜像), oss(对象存储), quotagroups(配额组), tenants(租户), netpolicies(网络策略), replicas(副本), process(worker), cleanpolicies(清理策略)  query:"ResourceType"
     Username: Optional[str] = None    # 用户名称（模糊搜索）  query:"Username,omitempty"
 
 @dataclass
 class ListEventsReq:
     Kind: str    # 对象类型  query:"Kind"
-    Limit: Optional[int] = None    # 分页  query:"Limit,omitempty"
     Name: str    # 对象名称  query:"Name"
-    Offset: Optional[int] = None    # 分页偏移量（可选，默认 0）  query:"Offset,omitempty"
     Project: str    # 项目名 (必填)  query:"Project"
     UId: str    # UId  query:"UId"
+    Limit: Optional[int] = None    # 分页  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 分页偏移量（可选，默认 0）  query:"Offset,omitempty"
+    Order: Optional[str] = None    # 排序方向: asc, desc，默认 desc  query:"Order,omitempty"
+    SortBy: Optional[str] = None    # 排序  query:"SortBy,omitempty"
 
 @dataclass
 class ListNodeConfigurationReq:
@@ -462,11 +468,11 @@ class ListNodeConfigurationReq:
 
 @dataclass
 class ListNodeInstancesReq:
-    InstanceStatus: Optional[List[str]] = None    # Instance 状态筛选  query:"InstanceStatus,omitempty"
     InstanceType: List[str]    # 资源类型筛选（worker, workspace, job, ray, other）  query:"InstanceType"
+    NodeName: str    # 节点名  query:"NodeName"
+    InstanceStatus: Optional[List[str]] = None    # Instance 状态筛选  query:"InstanceStatus,omitempty"
     Keyword: Optional[str] = None    # 关键字搜索  query:"Keyword,omitempty"
     Limit: Optional[int] = None    # 分页大小(min=1,max=100) 默认10  query:"Limit,omitempty"
-    NodeName: str    # 节点名  query:"NodeName"
     Offset: Optional[int] = None    # 分页偏移量(min=0) 默认0  query:"Offset,omitempty"
     Order: Optional[str] = None    # 排序方向: asc, desc  query:"Order,omitempty"
     SortBy: Optional[str] = None    # 排序字段  query:"SortBy,omitempty"
@@ -497,9 +503,9 @@ class ListNodesReq:
 
 @dataclass
 class ListProjectUsersReq:
+    Project: str    # 项目名  query:"Project"
     Limit: Optional[int] = None    # 分页大小(min=1,max=100) 默认10  query:"Limit,omitempty"
     Offset: Optional[int] = None    # 分页偏移量(min=0) 默认0  query:"Offset,omitempty"
-    Project: str    # 项目名  query:"Project"
     Role: Optional[str] = None    # 角色 枚举值：manager (管理员), operator (操作员) SDK常量: RoleManager, RoleOperator  query:"Role,omitempty"
 
 @dataclass
@@ -520,29 +526,31 @@ class ListProjectsSimpleReq:
 
 @dataclass
 class ListQuotaGroupsReq:
+    Project: str    # 项目名  query:"Project"
     IsBelongsTo: Optional[bool] = None    # 是否只获取当前用户所在的配额组  query:"IsBelongsTo,omitempty"
     Limit: Optional[int] = None    # 分页大小(min=1,max=100) 默认10  query:"Limit,omitempty"
     MachineType: Optional[str] = None    # 机器类型筛选 可选CPU，GPU SDK常量: MachineTypeCPU, MachineTypeGPU  query:"MachineType,omitempty"
     Offset: Optional[int] = None    # 分页偏移量(min=0) 默认0  query:"Offset,omitempty"
     Order: Optional[str] = None    # 排序方向: asc, desc  query:"Order,omitempty"
-    Project: str    # 项目名  query:"Project"
     QuotaGroup: Optional[str] = None    # 按配额组名模糊搜索（子串匹配）  query:"QuotaGroup,omitempty"
     SortBy: Optional[str] = None    # 排序字段: CreationTime，空=不排序  query:"SortBy,omitempty"
     UsageType: Optional[str] = None    # 使用类型筛选，可选workspace,workload SDK常量: UsageTypeWorkspace, UsageTypeWorkload  query:"UsageType,omitempty"
 
 @dataclass
 class ListQuotaGroupsSimpleReq:
+    Project: str    # 项目名  query:"Project"
     Limit: Optional[int] = None    # 分页大小(min=1,max=100) 默认10  query:"Limit,omitempty"
     Offset: Optional[int] = None    # 分页偏移量(min=0) 默认0  query:"Offset,omitempty"
-    Project: str    # 项目名  query:"Project"
     UserName: Optional[str] = None    # 用户名  query:"UserName,omitempty"
 
 @dataclass
 class ListSKUsReq:
+    SKUType: str    # SKU类型：cpu或gpu  query:"SKUType"
+    Internet: Optional[bool] = None    # 是否联网  query:"Internet,omitempty"
     Keyword: Optional[str] = None    # 关键字搜索  query:"Keyword,omitempty"
-    Limit: Optional[int] = None    # 分页大小  query:"Limit,omitempty"
-    Offset: Optional[int] = None    # 分页偏移量  query:"Offset,omitempty"
+    Limit: Optional[int] = None    # 分页大小（可选，默认 20，最大 100）  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 分页偏移量（可选，默认 0）  query:"Offset,omitempty"
+    Project: Optional[str] = None    # Scope为project时必填  query:"Project,omitempty"
     ResourceType: Optional[str] = None    # 资源类型：用于过滤SKU适用的资源类型（如job、workspace、ray），空表示所有类型  query:"ResourceType,omitempty"
-    SKUType: str    # SKU类型：cpu或gpu  query:"SKUType"
     Scope: Optional[str] = None    # SKU可见范围：public(公域)、tenant(租域)、project(项目域)，空默认为public  query:"Scope,omitempty"
 

{yicloud_sdk_python-0.2.0 → yicloud_sdk_python-0.3.0}/yicloud/services/oss/models.py

@@ -34,38 +34,41 @@ class Type:
 # Models
 @dataclass
 class Authorization:
-    Mode: Optional[str] = None    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode,omitempty"
-    Name: Optional[str] = ""    # 被分享对象名字  json:"Name,omitempty"
-    Type: Optional[str] = None    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type,omitempty"
+    Mode: str    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode"
+    Name: str    # 被分享者名  json:"Name"
+    Type: str    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type"
 
 @dataclass
 class CreateBucketReqAuthorization:
-    Mode: Optional[str] = None    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode,omitempty"
-    Name: Optional[str] = None    # 被分享对象名字  json:"Name,omitempty"
-    Type: Optional[str] = None    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type,omitempty"
+    Mode: str    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode"
+    Name: str    # 被分享者名  json:"Name"
+    Type: str    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type"
 
 @dataclass
 class UpdateBucketReqAuthorization:
-    Mode: Optional[str] = None    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode,omitempty"
-    Name: Optional[str] = None    # 被分享对象名字  json:"Name,omitempty"
-    Type: Optional[str] = None    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type,omitempty"
+    Mode: str    # SDK常量: ModeREADONLY, ModeREADWRITE, ModeFULL_CONTROL  json:"Mode"
+    Name: str    # 被分享者名  json:"Name"
+    Type: str    # SDK常量: TypeCanonicalUser, TypeGROUP, TypePROJECT  json:"Type"
 
 @dataclass
 class BucketResponse:
-    Authorizations: Optional[List[Authorization]] = None    # json:"Authorizations,omitempty"
-    Bucket: Optional[str] = ""    # json:"Bucket,omitempty"
-    Owner: Optional[str] = ""    # json:"Owner,omitempty"
+    Authorizations: Optional[List[Authorization]] = None    # 权限分享  json:"Authorizations,omitempty"
+    Bucket: Optional[str] = ""    # 存储桶名  json:"Bucket,omitempty"
+    Created: Optional[str] = ""    # 创建时间  json:"Created,omitempty"
+    DeletedTime: Optional[str] = ""    # 删除时间（回收站中显示）  json:"DeletedTime,omitempty"
+    Owner: Optional[str] = ""    # 所有者  json:"Owner,omitempty"
     Permission: Optional[str] = None    # SDK常量: PermissionDENY, PermissionREADONLY, PermissionREADWRITE, PermissionPUBLIC_READ, PermissionADMIN  json:"Permission,omitempty"
-    ProjectID: Optional[str] = ""    # json:"ProjectID,omitempty"
-    ProjectId: Optional[str] = ""    # json:"ProjectId,omitempty"
-    Size: Optional[str] = ""    # json:"Size,omitempty"
+    Project: Optional[str] = ""    # 所属项目  json:"Project,omitempty"
+    PublicRead: Optional[bool] = False    # 是否公共读  json:"PublicRead,omitempty"
+    ReadOnly: Optional[bool] = False    # 是否只读  json:"ReadOnly,omitempty"
+    Size: Optional[str] = ""    # 当前容量  json:"Size,omitempty"
     State: Optional[str] = None    # SDK常量: StateSTATE_PENDING, StateSTATE_READY, StateSTATE_FAILED, StateSTATE_DELETED  json:"State,omitempty"
-    Tenant: Optional[str] = ""    # json:"Tenant,omitempty"
+    Tenant: Optional[str] = ""    # 所属租户  json:"Tenant,omitempty"
 
 @dataclass
 class CreateBucketReq:
-    Bucket: str    # Bucket名，命名规则参照AWS S3存储桶命名规则  json:"Bucket"
-    Project: str    # 所属Project  json:"Project"
+    Bucket: str    # 存储桶名  json:"Bucket"
+    Project: str    # 所属项目  json:"Project"
     Authorizations: Optional[List[CreateBucketReqAuthorization]] = None    # 权限分享  json:"Authorizations,omitempty"
     Description: Optional[str] = None    # 描述  json:"Description,omitempty"
 
@@ -75,21 +78,22 @@ class DeleteBucketReq:
 
 @dataclass
 class GetBucketData:
-    Authorizations: Optional[List[Authorization]] = None    # json:"Authorizations,omitempty"
-    Bucket: Optional[str] = ""    # json:"Bucket,omitempty"
-    Owner: Optional[str] = ""    # json:"Owner,omitempty"
+    Authorizations: Optional[List[Authorization]] = None    # 权限分享  json:"Authorizations,omitempty"
+    Bucket: Optional[str] = ""    # 存储桶名  json:"Bucket,omitempty"
+    Created: Optional[str] = ""    # 创建时间  json:"Created,omitempty"
+    Owner: Optional[str] = ""    # 所有者  json:"Owner,omitempty"
     Permission: Optional[str] = None    # SDK常量: PermissionDENY, PermissionREADONLY, PermissionREADWRITE, PermissionPUBLIC_READ, PermissionADMIN  json:"Permission,omitempty"
-    Project: Optional[str] = ""    # json:"Project,omitempty"
-    ProjectID: Optional[str] = ""    # json:"ProjectID,omitempty"
-    ProjectId: Optional[str] = ""    # json:"ProjectId,omitempty"
-    Size: Optional[str] = ""    # json:"Size,omitempty"
+    Project: Optional[str] = ""    # 所属项目  json:"Project,omitempty"
+    PublicRead: Optional[bool] = False    # 是否公共读  json:"PublicRead,omitempty"
+    ReadOnly: Optional[bool] = False    # 是否只读  json:"ReadOnly,omitempty"
+    Size: Optional[str] = ""    # 当前容量  json:"Size,omitempty"
     State: Optional[str] = None    # SDK常量: StateSTATE_PENDING, StateSTATE_READY, StateSTATE_FAILED, StateSTATE_DELETED  json:"State,omitempty"
-    Tenant: Optional[str] = ""    # json:"Tenant,omitempty"
+    Tenant: Optional[str] = ""    # 所属租户  json:"Tenant,omitempty"
 
 @dataclass
 class ListBucketsData:
     Items: Optional[List[BucketResponse]] = None    # json:"Items,omitempty"
-    Total: Optional[int] = 0    # json:"Total,omitempty"
+    Total: Optional[int] = 0    # 总数  json:"Total,omitempty"
 
 @dataclass
 class CreateBucketData:
@@ -97,12 +101,12 @@ class CreateBucketData:
 
 @dataclass
 class UpdateBucketReq:
-    Bucket: str    # Bucket名  json:"Bucket"
+    Bucket: str    # 存储桶名  json:"Bucket"
     Authorizations: Optional[List[UpdateBucketReqAuthorization]] = None    # 权限分享  json:"Authorizations,omitempty"
-    Description: Optional[str] = None    # 对该Bucket的描述  json:"Description,omitempty"
-    Project: Optional[str] = None    # Bucket所属项目(只能在Bucket还没有归属某个项目时修改，一旦设置则无法再次更改)  json:"Project,omitempty"
-    PublicRead: Optional[bool] = None    # 是否可公共读  json:"PublicRead,omitempty"
-    ReadOnly: Optional[bool] = None    # 是否只读  json:"ReadOnly,omitempty"
+    Description: Optional[str] = None    # 描述  json:"Description,omitempty"
+    Project: Optional[str] = None    # 所属项目(当项目一旦被设置则不可更改)  json:"Project,omitempty"
+    PublicRead: Optional[str] = None    # 公共读  json:"PublicRead,omitempty"
+    ReadOnly: Optional[str] = None    # 只读  json:"ReadOnly,omitempty"
 
 @dataclass
 class GetBucketReq:
@@ -110,12 +114,12 @@ class GetBucketReq:
 
 @dataclass
 class ListBucketsReq:
-    SortOrder: Optional[str] = None    # 排序方向 (asc, desc, 默认asc)  query:"SortOrder,omitempty"
-    Offset: Optional[int] = None    # 偏移量 (默认 0, 0 <= Offset)  query:"Offset,omitempty"
-    Limit: Optional[int] = None    # 每页数量限制(默认100, 0 < Limit <= 100)  query:"Limit,omitempty"
-    SortBy: Optional[str] = None    # 排序规则(created, size, 默认:created)  query:"SortBy,omitempty"
     Keyword: Optional[str] = None    # 过滤条件，可以填项目名/桶名/所有者  query:"Keyword,omitempty"
+    Limit: Optional[int] = None    # 每页数量限制(默认100, 0 < Limit <= 100)  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 偏移量 (默认 0, 0 <= Offset)  query:"Offset,omitempty"
     Owner: Optional[str] = None    # 所有者  query:"Owner,omitempty"
+    SortBy: Optional[str] = None    # 排序规则(created,size,默认created)  query:"SortBy,omitempty"
+    SortOrder: Optional[str] = None    # 排序方向 (asc, desc, 默认asc)  query:"SortOrder,omitempty"
 
 
 DeleteBucketData = CreateBucketData