yicloud-sdk-python 0.4.2__tar.gz → 0.5.0__tar.gz

{yicloud_sdk_python-0.4.2/yicloud_sdk_python.egg-info → yicloud_sdk_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yicloud-sdk-python
-Version: 0.4.2
+Version: 0.5.0
 Summary: YiCloud OpenAPI SDK for Python
 Author: YiCloud
 Project-URL: Homepage, https://gitee.com/yicloud-team/openapi-sdk-python
@@ -114,14 +114,15 @@ except base.exc.YiCloudException as e:
 | FS | `yicloud.services.fs` | 9 | 文件系统 FS |
 | IAM | `yicloud.services.iam` | 12 | 访问控制 IAM |
 | Inferset | `yicloud.services.inferset` | 21 | 模型推理服务 INFERSET |
-| JOB | `yicloud.services.job` | 13 | 训练任务 JOB |
-| MC | `yicloud.services.mc` | 29 | 管理中心 MC |
+| JOB | `yicloud.services.job` | 14 | 训练任务 JOB |
+| MC | `yicloud.services.mc` | 31 | 管理中心 MC |
 | Modelrepo | `yicloud.services.modelrepo` | 11 | 模型仓库 MODELREPO |
 | Monitor | `yicloud.services.monitor` | 1 | 监控中心 MONITOR |
 | OSS | `yicloud.services.oss` | 5 | 对象存储OSS |
 | RAY | `yicloud.services.ray` | 9 | 分布式计算 Ray |
 | Registry | `yicloud.services.registry` | 9 | 镜像仓库 REGISTRY |
-| Sandbox | `yicloud.services.sandbox` | 19 | 沙盒 SANDBOX |
+| Sandbox | `yicloud.services.sandbox` | 23 | 沙盒 SANDBOX |
+| Service | `yicloud.services.service` | 9 | 服务 SERVICE |
 | Volume | `yicloud.services.volume` | 12 | 云盘管理 Volume |
 | Workspace | `yicloud.services.workspace` | 20 | 开发机 WS |
 
@@ -137,7 +138,7 @@ yicloud/                    # Main package
 │   ├── log/                # Logger
 │   ├── msgs/               # Response types (Rsp[T], Header, RspMeta)
 │   └── utils/              # Utilities
-└── services/               # Business services (15 services)
+└── services/               # Business services (16 services)
     ├── bc/         # 账单管理 BC
     ├── dataset/    # 数据集 DATASET
     ├── fs/         # 文件系统 FS
@@ -151,6 +152,7 @@ yicloud/                    # Main package
     ├── ray/        # 分布式计算 Ray
     ├── registry/   # 镜像仓库 REGISTRY
     ├── sandbox/    # 沙盒 SANDBOX
+    ├── service/    # 服务 SERVICE
     ├── volume/     # 云盘管理 Volume
     ├── workspace/  # 开发机 WS
 examples/                   # Example code (one per service)

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/README.md

@@ -75,14 +75,15 @@ except base.exc.YiCloudException as e:
 | FS | `yicloud.services.fs` | 9 | 文件系统 FS |
 | IAM | `yicloud.services.iam` | 12 | 访问控制 IAM |
 | Inferset | `yicloud.services.inferset` | 21 | 模型推理服务 INFERSET |
-| JOB | `yicloud.services.job` | 13 | 训练任务 JOB |
-| MC | `yicloud.services.mc` | 29 | 管理中心 MC |
+| JOB | `yicloud.services.job` | 14 | 训练任务 JOB |
+| MC | `yicloud.services.mc` | 31 | 管理中心 MC |
 | Modelrepo | `yicloud.services.modelrepo` | 11 | 模型仓库 MODELREPO |
 | Monitor | `yicloud.services.monitor` | 1 | 监控中心 MONITOR |
 | OSS | `yicloud.services.oss` | 5 | 对象存储OSS |
 | RAY | `yicloud.services.ray` | 9 | 分布式计算 Ray |
 | Registry | `yicloud.services.registry` | 9 | 镜像仓库 REGISTRY |
-| Sandbox | `yicloud.services.sandbox` | 19 | 沙盒 SANDBOX |
+| Sandbox | `yicloud.services.sandbox` | 23 | 沙盒 SANDBOX |
+| Service | `yicloud.services.service` | 9 | 服务 SERVICE |
 | Volume | `yicloud.services.volume` | 12 | 云盘管理 Volume |
 | Workspace | `yicloud.services.workspace` | 20 | 开发机 WS |
 
@@ -98,7 +99,7 @@ yicloud/                    # Main package
 │   ├── log/                # Logger
 │   ├── msgs/               # Response types (Rsp[T], Header, RspMeta)
 │   └── utils/              # Utilities
-└── services/               # Business services (15 services)
+└── services/               # Business services (16 services)
     ├── bc/         # 账单管理 BC
     ├── dataset/    # 数据集 DATASET
     ├── fs/         # 文件系统 FS
@@ -112,6 +113,7 @@ yicloud/                    # Main package
     ├── ray/        # 分布式计算 Ray
     ├── registry/   # 镜像仓库 REGISTRY
     ├── sandbox/    # 沙盒 SANDBOX
+    ├── service/    # 服务 SERVICE
     ├── volume/     # 云盘管理 Volume
     ├── workspace/  # 开发机 WS
 examples/                   # Example code (one per service)

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/pyproject.toml

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

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/version.py

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

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/__init__.py

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

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/__init__.py

@@ -14,6 +14,7 @@ from . import oss
 from . import ray
 from . import registry
 from . import sandbox
+from . import service
 from . import volume
 from . import workspace
 
@@ -31,6 +32,7 @@ __all__ = [
     "ray",
     "registry",
     "sandbox",
+    "service",
     "volume",
     "workspace",
 ]

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/fs/actions.py

@@ -98,7 +98,7 @@ async def create_fileset_with_quota_async(ctx: Optional[dict], req: models.Creat
 
 
 def list_available_gpfs_clusters(ctx: Optional[dict], req: models.ListAvailableGpfsClustersReq) -> models.ListAvailableGpfsClustersData:
-    """查询指定 Region 和 Zone 下的可用文件存储集群
+    """查询可用文件存储集群
     根据 RegionId 和 ZoneId 查询该可用区下可挂载的可用文件存储集群
     GET /fs/v1alpha2/ListAvailableGpfsClusters
     Action: ListAvailableGpfsClusters
@@ -113,7 +113,7 @@ def list_available_gpfs_clusters(ctx: Optional[dict], req: models.ListAvailableG
 
 
 async def list_available_gpfs_clusters_async(ctx: Optional[dict], req: models.ListAvailableGpfsClustersReq) -> models.ListAvailableGpfsClustersData:
-    """查询指定 Region 和 Zone 下的可用文件存储集群（异步）
+    """查询可用文件存储集群（异步）
     根据 RegionId 和 ZoneId 查询该可用区下可挂载的可用文件存储集群
     GET /fs/v1alpha2/ListAvailableGpfsClusters
     Action: ListAvailableGpfsClusters

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/job/actions.py

@@ -11,7 +11,7 @@ _LAST_VERSION = "v1alpha1"
 
 def list_jobs(ctx: Optional[dict], req: models.ListJobsReq) -> models.ListJobsData:
     """获取 Job 列表
-    分页获取 Job 列表，支持按名称、状态、创建者、配额组等条件过滤
+    分页获取 Job 列表，支持按名称、状态、创建者、配额组、资源池等条件过滤
     GET /job/v1alpha1/ListJobs
     Action: ListJobs
 
@@ -26,7 +26,7 @@ def list_jobs(ctx: Optional[dict], req: models.ListJobsReq) -> models.ListJobsDa
 
 async def list_jobs_async(ctx: Optional[dict], req: models.ListJobsReq) -> models.ListJobsData:
     """获取 Job 列表（异步）
-    分页获取 Job 列表，支持按名称、状态、创建者、配额组等条件过滤
+    分页获取 Job 列表，支持按名称、状态、创建者、配额组、资源池等条件过滤
     GET /job/v1alpha1/ListJobs
     Action: ListJobs
 

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/job/models.py

@@ -92,19 +92,21 @@ class CreateJobReq:
     TaskSpecs: Dict[str, CreateJobReqTaskSpec]    # 任务规格映射，key 为任务名（如 t0），value 为任务规格  json:"TaskSpecs"
     ZoneId: str    # 可用区（AZ），必填；RegionId 由网关通过 X-OGW-REGION-ID 请求头注入  json:"ZoneId"
     AutoDeleteDuration: Optional[str] = None    # 自动删除时间，如 24h  json:"AutoDeleteDuration,omitempty"
-    BackoffLimit: Optional[int] = None    # 重试次数限制  json:"BackoffLimit,omitempty"
+    BackoffLimit: Optional[int] = None    # 重试次数限制（0-20，默认 5）  json:"BackoffLimit,omitempty"
     Creator: Optional[str] = None    # 创建者用户名  json:"Creator,omitempty"
     CreatorId: Optional[str] = None    # 创建者用户 ID  json:"CreatorId,omitempty"
     EnableSSHD: Optional[bool] = None    # 是否为所有任务统一启用 SSH；设为 true 时覆盖所有 TaskSpec 的 EnableSSHD  json:"EnableSSHD,omitempty"
     FailurePolicy: Optional[str] = None    # SDK常量: FailurePolicyNone, FailurePolicyCloseAllTasks  json:"FailurePolicy,omitempty"
     JobId: Optional[str] = None    # Job 唯一标识  json:"JobId,omitempty"
     Mount: Optional[str] = None    # 只读 hostPath 挂载路径  json:"Mount,omitempty"
+    PoolName: Optional[str] = None    # 资源池名称，可选；写入 RJob 标签 brainpp.machine.cn/pool-name  json:"PoolName,omitempty"
     PreCheckConfig: Optional[CreateJobReqPreCheckConfig] = None    # 训前检查配置  json:"PreCheckConfig,omitempty"
-    Priority: Optional[str] = None    # 优先级（整数 1-9，默认 5）  json:"Priority,omitempty"
+    Priority: Optional[str] = None    # 优先级（整数 1-9）。未传时使用资源组 PriorityLimit，无资源组时默认 5；优先级 1-3 为可抢占任务，不允许开启自愈和训前检查  json:"Priority,omitempty"
     Qos: Optional[str] = None    # 服务质量等级  json:"Qos,omitempty"
     QuotaGroup: Optional[str] = None    # 所在配额组  json:"QuotaGroup,omitempty"
     RealCreator: Optional[str] = None    # 实际创建者用户名（共享场景下与 Creator 不同）  json:"RealCreator,omitempty"
     RealCreatorId: Optional[str] = None    # 实际创建者用户 ID（共享场景下与 CreatorId 不同）  json:"RealCreatorId,omitempty"
+    RestartPolicy: Optional[str] = None    # SDK常量: RestartPolicyAlways, RestartPolicyOnFailure, RestartPolicyNever, RestartPolicyRestartJobOnFailure, RestartPolicyRestartPreferNewMachine  json:"RestartPolicy,omitempty"
     S3Config: Optional[CreateJobReqS3Config] = None    # json:"S3Config,omitempty"
     SKUPrivate: Optional[bool] = None    # 是否使用私有机器 SKU  json:"SKUPrivate,omitempty"
     SKUPrivateProject: Optional[bool] = None    # 是否为项目级私有 SKU  json:"SKUPrivateProject,omitempty"
@@ -118,6 +120,7 @@ class CreateJobData:
     CreationTime: Optional[str] = ""    # 创建时间（RFC3339 格式）  json:"CreationTime,omitempty"
     JobId: Optional[str] = ""    # Job 唯一标识  json:"JobId,omitempty"
     Name: Optional[str] = ""    # Job 名称  json:"Name,omitempty"
+    PoolName: Optional[str] = ""    # 资源池名称，写入 RJob 标签 brainpp.machine.cn/pool-name；未设置时不返回  json:"PoolName,omitempty"
     Project: Optional[str] = ""    # 项目名称  json:"Project,omitempty"
     Uid: Optional[str] = ""    # Job 唯一标识（UID）  json:"Uid,omitempty"
 
@@ -159,10 +162,11 @@ class GetJobData:
     Mount: Optional[str] = ""    # 只读 hostPath 挂载路径  json:"Mount,omitempty"
     Name: Optional[str] = ""    # Job 显示名称  json:"Name,omitempty"
     Phase: Optional[str] = None    # SDK常量: PhasePending, PhaseStarting, PhaseRunning, PhaseScanning, PhaseSucceeded, PhaseFailed, PhaseRestarting, PhaseStopped, PhaseInqueue, PhaseSelfHealTriggered, PhaseSelfHealRunning, PhaseSelfHealSucceeded, PhaseSelfHealFailed  json:"Phase,omitempty"
+    PoolName: Optional[str] = ""    # 所在资源池名称，读取 RJob 标签 brainpp.machine.cn/pool-name；未设置时不返回  json:"PoolName,omitempty"
     PreCheckConfig: Optional[PreCheckConfig] = None    # 训前检查配置  json:"PreCheckConfig,omitempty"
     PreCheckEnabled: Optional[bool] = False    # 是否开启训前检查  json:"PreCheckEnabled,omitempty"
     PrecheckStatus: Optional[str] = ""    # 训前检查状态（取自 GetPrecheckStatus 返回的 data.status），仅 ListJobs 接口返回。 仅当 PreCheckEnabled=true 且 JobId/Uid 均非空时才会查询并返回该字段；未开启训前检查的 Job 不返回。 查询时使用 JobId 与 Uid 联合查询（与 GetPrecheckStatus 接口一致）。 查询失败时为 UNScan，表示状态未知。   json:"PrecheckStatus,omitempty"
-    Priority: Optional[str] = ""    # 优先级  json:"Priority,omitempty"
+    Priority: Optional[str] = ""    # 优先级；缺失时按资源组 PriorityLimit 回填，无有效上限时回填 9  json:"Priority,omitempty"
     Project: Optional[str] = ""    # 项目名称  json:"Project,omitempty"
     Qos: Optional[str] = ""    # 服务质量等级  json:"Qos,omitempty"
     QuotaGroup: Optional[str] = ""    # 所在配额组  json:"QuotaGroup,omitempty"
@@ -170,6 +174,8 @@ class GetJobData:
     RealCreator: Optional[str] = ""    # 实际创建者用户名（共享场景下与 Creator 不同）  json:"RealCreator,omitempty"
     RealCreatorId: Optional[str] = ""    # 实际创建者用户 ID（共享场景下与 CreatorId 不同）  json:"RealCreatorId,omitempty"
     RegionId: Optional[str] = ""    # 地域，从 RJob topology labels 读取；存量数据缺失时回填默认值 cn-shanghai  json:"RegionId,omitempty"
+    RestartCount: Optional[int] = 0    # 容器重启次数，取自 RJob status.restartCount  json:"RestartCount,omitempty"
+    RestartPolicy: Optional[str] = None    # SDK常量: RestartPolicyAlways, RestartPolicyOnFailure, RestartPolicyNever, RestartPolicyRestartJobOnFailure, RestartPolicyRestartPreferNewMachine  json:"RestartPolicy,omitempty"
     S3Config: Optional[S3Config] = None    # json:"S3Config,omitempty"
     SKUPrivate: Optional[bool] = False    # 是否使用私有机器 SKU  json:"SKUPrivate,omitempty"
     SKUPrivateProject: Optional[bool] = False    # 是否为项目级私有 SKU  json:"SKUPrivateProject,omitempty"
@@ -181,6 +187,7 @@ class GetJobData:
     SelfHealLimitCount: Optional[int] = 0    # 自愈最大重试次数  json:"SelfHealLimitCount,omitempty"
     SelfHealNotifyWebhook: Optional[str] = ""    # 自愈事件通知 Webhook URL  json:"SelfHealNotifyWebhook,omitempty"
     SelfHealRetryScope: Optional[str] = ""    # 自愈重试粒度（rjob/task）  json:"SelfHealRetryScope,omitempty"
+    SelfHealTerminationGracePeriodSeconds: Optional[int] = 0    # 自愈数据回收时间（秒），读取自愈注解 self-health.brainpp.cn/termination-grace-period-seconds；未设置时不返回  json:"SelfHealTerminationGracePeriodSeconds,omitempty"
     StopTime: Optional[str] = ""    # 停止时间（RFC3339 格式）  json:"StopTime,omitempty"
     TaskSpecs: Optional[Dict[str, TaskSpecResponse]] = None    # 任务规格映射，key 为任务名（如 t0），value 为任务规格  json:"TaskSpecs,omitempty"
     TaskStatusCounts: Optional[Dict[str, TaskStatusCount]] = None    # 各任务副本状态数量统计  json:"TaskStatusCounts,omitempty"
@@ -380,6 +387,7 @@ class TaskSpecResponse:
     PositiveTags: Optional[List[str]] = None    # 节点亲和标签列表  json:"PositiveTags,omitempty"
     RegionId: Optional[str] = ""    # 地域，从 TaskSpec template labels 读取；缺失时回填默认值 cn-shanghai  json:"RegionId,omitempty"
     Replicas: Optional[int] = 0    # 副本数  json:"Replicas,omitempty"
+    RestartPolicy: Optional[str] = None    # SDK常量: RestartPolicyAlways, RestartPolicyOnFailure, RestartPolicyNever, RestartPolicyRestartJobOnFailure, RestartPolicyRestartPreferNewMachine  json:"RestartPolicy,omitempty"
     RootfsSource: Optional[RootfsSourceResponse] = None    # Rootfs 数据源配置  json:"RootfsSource,omitempty"
     SKUId: Optional[str] = ""    # SKU 规格标识，如 ai.c3m42.r1ir5  json:"SKUId,omitempty"
     UpdatePolicy: Optional[str] = None    # SDK常量: UpdatePolicyActive, UpdatePolicyBeforeRunning, UpdatePolicyNone  json:"UpdatePolicy,omitempty"
@@ -470,6 +478,7 @@ class ListJobsReq:
     Limit: Optional[int] = None    # 分页大小，最大值 100  query:"Limit,omitempty"
     Offset: Optional[int] = None    # 分页偏移量  query:"Offset,omitempty"
     Phases: Optional[str] = None    # 按状态过滤（逗号分隔，如 Pending,Running,Succeeded）  query:"Phases,omitempty"
+    PoolName: Optional[str] = None    # 按资源池名称过滤（逗号分隔多个资源池名称，等值匹配）  query:"PoolName,omitempty"
     QuotaGroup: Optional[str] = None    # 按配额组过滤（逗号分隔多个配额组）  query:"QuotaGroup,omitempty"
     Self: Optional[bool] = None    # 是否只看自己创建的任务  query:"Self,omitempty"
     SortBy: Optional[str] = None    # 排序字段，如 CreationTime  query:"SortBy,omitempty"

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/mc/__init__.py

@@ -11,6 +11,7 @@ from .actions import (
     create_quota_group,
     delete_project,
     delete_quota_group,
+    get_low_priority_usage,
     get_node_quota,
     get_project,
     get_project_quota,
@@ -28,6 +29,7 @@ from .actions import (
     list_projects_with_sku_quotas,
     list_quota_groups,
     list_quota_groups_simple,
+    list_quota_groups_under_tenant,
     list_skus,
     list_zones,
     operate_node,
@@ -40,6 +42,7 @@ from .actions import (
     create_quota_group_async,
     delete_project_async,
     delete_quota_group_async,
+    get_low_priority_usage_async,
     get_node_quota_async,
     get_project_async,
     get_project_quota_async,
@@ -57,6 +60,7 @@ from .actions import (
     list_projects_with_sku_quotas_async,
     list_quota_groups_async,
     list_quota_groups_simple_async,
+    list_quota_groups_under_tenant_async,
     list_skus_async,
     list_zones_async,
     operate_node_async,
@@ -96,6 +100,7 @@ from .models import (
     ListQuotaGroupsSimpleData,
     ListSKUsData,
     ListZonesData,
+    GetLowPriorityUsageData,
     Metadata,
     ListNodeConfigurationData,
     NodeData,
@@ -132,6 +137,7 @@ from .models import (
     UpdateQuotaGroupReq,
     ZoneData,
     DeleteQuotaGroupReq,
+    GetLowPriorityUsageReq,
     GetNodeQuotaReq,
     GetProjectReq,
     GetProjectQuotaReq,
@@ -149,7 +155,9 @@ from .models import (
     ListProjectsWithSkuQuotasReq,
     ListQuotaGroupsReq,
     ListQuotaGroupsSimpleReq,
+    ListQuotaGroupsUnderTenantReq,
     ListSKUsReq,
     ListZonesReq,
     ListQuotaGroupsData,
+    ListQuotaGroupsUnderTenantData,
 )

{yicloud_sdk_python-0.4.2 → yicloud_sdk_python-0.5.0}/yicloud/services/mc/actions.py

@@ -95,7 +95,7 @@ async def create_project_async(ctx: Optional[dict], req: models.CreateProjectReq
 
 def create_quota_group(ctx: Optional[dict], req: models.CreateQuotaGroupReq):
     """创建配额组
-    创建配额组
+    创建配额组（v1.9.0 资源池：入参必填 PoolId 挂池；PRD 优先级上限：入参可选 PriorityLimit（1-9，默认 9=不限制）；Description/Tags 已按产品要求移除）
     POST /mc/v1alpha1/CreateQuotaGroup
     Action: CreateQuotaGroup
 
@@ -109,7 +109,7 @@ def create_quota_group(ctx: Optional[dict], req: models.CreateQuotaGroupReq):
 
 async def create_quota_group_async(ctx: Optional[dict], req: models.CreateQuotaGroupReq):
     """创建配额组（异步）
-    创建配额组
+    创建配额组（v1.9.0 资源池：入参必填 PoolId 挂池；PRD 优先级上限：入参可选 PriorityLimit（1-9，默认 9=不限制）；Description/Tags 已按产品要求移除）
     POST /mc/v1alpha1/CreateQuotaGroup
     Action: CreateQuotaGroup
 
@@ -177,6 +177,36 @@ async def delete_quota_group_async(ctx: Optional[dict], req: models.DeleteQuotaG
     await client.base.post_async(ctx, path, req, rsp)
 
 
+def get_low_priority_usage(ctx: Optional[dict], req: models.GetLowPriorityUsageReq) -> models.GetLowPriorityUsageData:
+    """查询低优资源占用
+    查询低优（priority 1-3）Running pod 的资源占用，不计入配额；支持池/组双维度查询
+    GET /mc/v1alpha1/GetLowPriorityUsage
+    Action: GetLowPriorityUsage
+
+    Returns GetLowPriorityUsageData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetLowPriorityUsage"
+    rsp = msgs.Rsp[models.GetLowPriorityUsageData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def get_low_priority_usage_async(ctx: Optional[dict], req: models.GetLowPriorityUsageReq) -> models.GetLowPriorityUsageData:
+    """查询低优资源占用（异步）
+    查询低优（priority 1-3）Running pod 的资源占用，不计入配额；支持池/组双维度查询
+    GET /mc/v1alpha1/GetLowPriorityUsage
+    Action: GetLowPriorityUsage
+
+    Returns GetLowPriorityUsageData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetLowPriorityUsage"
+    rsp = msgs.Rsp[models.GetLowPriorityUsageData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
 def get_node_quota(ctx: Optional[dict], req: models.GetNodeQuotaReq) -> models.GetNodeQuotaData:
     """获取节点配额
     获取节点配额
@@ -299,7 +329,7 @@ async def get_project_quota_limit_async(ctx: Optional[dict], req: models.GetProj
 
 def get_quota_group(ctx: Optional[dict], req: models.GetQuotaGroupReq) -> models.GetQuotaGroupData:
     """获取配额组
-    获取配额组信息
+    获取配额组信息（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，默认 9））
     GET /mc/v1alpha1/GetQuotaGroup
     Action: GetQuotaGroup
 
@@ -314,7 +344,7 @@ def get_quota_group(ctx: Optional[dict], req: models.GetQuotaGroupReq) -> models
 
 async def get_quota_group_async(ctx: Optional[dict], req: models.GetQuotaGroupReq) -> models.GetQuotaGroupData:
     """获取配额组（异步）
-    获取配额组信息
+    获取配额组信息（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，默认 9））
     GET /mc/v1alpha1/GetQuotaGroup
     Action: GetQuotaGroup
 
@@ -479,7 +509,18 @@ async def list_nodes_async(ctx: Optional[dict], req: models.ListNodesReq) -> mod
 
 def list_project_quota_groups(ctx: Optional[dict], req: models.ListProjectQuotaGroupsReq) -> models.ListProjectQuotaGroupsData:
     """查看当前项目下配额组列表
-    列出项目下配额组
+    列出项目下配额组（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，值越大优先级越高，默认 9））
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
     GET /mc/v1alpha1/ListProjectQuotaGroups
     Action: ListProjectQuotaGroups
 
@@ -494,7 +535,18 @@ def list_project_quota_groups(ctx: Optional[dict], req: models.ListProjectQuotaG
 
 async def list_project_quota_groups_async(ctx: Optional[dict], req: models.ListProjectQuotaGroupsReq) -> models.ListProjectQuotaGroupsData:
     """查看当前项目下配额组列表（异步）
-    列出项目下配额组
+    列出项目下配额组（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，值越大优先级越高，默认 9））
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
     GET /mc/v1alpha1/ListProjectQuotaGroups
     Action: ListProjectQuotaGroups
 
@@ -629,7 +681,18 @@ async def list_projects_with_sku_quotas_async(ctx: Optional[dict], req: models.L
 
 def list_quota_groups(ctx: Optional[dict], req: models.ListQuotaGroupsReq) -> models.ListQuotaGroupsData:
     """查看配额组列表
-    列出配额组
+    列出配额组（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，值越大优先级越高，默认 9））
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
     GET /mc/v1alpha1/ListQuotaGroups
     Action: ListQuotaGroups
 
@@ -644,7 +707,18 @@ def list_quota_groups(ctx: Optional[dict], req: models.ListQuotaGroupsReq) -> mo
 
 async def list_quota_groups_async(ctx: Optional[dict], req: models.ListQuotaGroupsReq) -> models.ListQuotaGroupsData:
     """查看配额组列表（异步）
-    列出配额组
+    列出配额组（v1.9.0 资源池：出参新增 PoolId/PoolName/MachineCount/GpuModels（始终返回，未挂池为空值）与 PublicNetworks（机器 label 派生）；PRD 优先级上限：出参 PriorityLimit（1-9，值越大优先级越高，默认 9））
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
     GET /mc/v1alpha1/ListQuotaGroups
     Action: ListQuotaGroups
 
@@ -687,6 +761,58 @@ async def list_quota_groups_simple_async(ctx: Optional[dict], req: models.ListQu
     return rsp.get_typed_data()
 
 
+def list_quota_groups_under_tenant(ctx: Optional[dict], req: models.ListQuotaGroupsUnderTenantReq) -> models.ListQuotaGroupsUnderTenantData:
+    """查看租户下配额组列表
+    列出租户下全部配额组（v1.9.1 新增：跨项目全量；仅租户管理员，非租户管理员 403；过滤/排序/分页与 ListQuotaGroups 同语义）
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
+    GET /mc/v1alpha1/ListQuotaGroupsUnderTenant
+    Action: ListQuotaGroupsUnderTenant
+
+    Returns ListQuotaGroupsUnderTenantData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListQuotaGroupsUnderTenant"
+    rsp = msgs.Rsp[models.ListQuotaGroupsUnderTenantData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def list_quota_groups_under_tenant_async(ctx: Optional[dict], req: models.ListQuotaGroupsUnderTenantReq) -> models.ListQuotaGroupsUnderTenantData:
+    """查看租户下配额组列表（异步）
+    列出租户下全部配额组（v1.9.1 新增：跨项目全量；仅租户管理员，非租户管理员 403；过滤/排序/分页与 ListQuotaGroups 同语义）
+排序：支持 SortBy 参数（字段大小区分不敏感）
+- PriorityLimit: 按优先级上限排序
+- CreationTime: 按创建时间排序
+- Name: 按配额组名称排序
+- PoolName: 按资源池排序（v1.9.0）
+- Region: 按区域排序（v1.9.0 多 AZ）
+- SchedStrategy: 按调度策略排序
+- MachineCount: 按组可用机器数排序（v1.9.0 资源池；count 相同时按创建时间降序）
+- PodCount: 按组内 Running pod 数排序（v1.9.0；count 相同时按创建时间降序）
+- CPU/GPU/Memory/LocalDisk/DiskHdd/DiskSsd: 按资源总量排序（CPU=核、GPU=卡、Memory/本地盘=Gi；同值按创建时间降序）
+未传 SortBy 时默认按 CreationTime 降序排列
+    GET /mc/v1alpha1/ListQuotaGroupsUnderTenant
+    Action: ListQuotaGroupsUnderTenant
+
+    Returns ListQuotaGroupsUnderTenantData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListQuotaGroupsUnderTenant"
+    rsp = msgs.Rsp[models.ListQuotaGroupsUnderTenantData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
 def list_skus(ctx: Optional[dict], req: models.ListSKUsReq) -> models.ListSKUsData:
     """获取SKU列表
     获取SKU列表
@@ -833,7 +959,7 @@ async def update_project_async(ctx: Optional[dict], req: models.UpdateProjectReq
 
 def update_quota_group(ctx: Optional[dict], req: models.UpdateQuotaGroupReq):
     """更新配额组
-    更新配额组
+    更新配额组（UpdateOption：quota/user/quota_nodes/all；all 可同时更新配额和用户；池关联字段不可改——请求体无此字段，结构性拒改；PRD 优先级上限：可选 PriorityLimit（1-9，nil=不更新，仅 quota/all 生效））
     POST /mc/v1alpha1/UpdateQuotaGroup
     Action: UpdateQuotaGroup
 
@@ -847,7 +973,7 @@ def update_quota_group(ctx: Optional[dict], req: models.UpdateQuotaGroupReq):
 
 async def update_quota_group_async(ctx: Optional[dict], req: models.UpdateQuotaGroupReq):
     """更新配额组（异步）
-    更新配额组
+    更新配额组（UpdateOption：quota/user/quota_nodes/all；all 可同时更新配额和用户；池关联字段不可改——请求体无此字段，结构性拒改；PRD 优先级上限：可选 PriorityLimit（1-9，nil=不更新，仅 quota/all 生效））
     POST /mc/v1alpha1/UpdateQuotaGroup
     Action: UpdateQuotaGroup