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

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

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

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

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

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

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

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

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

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

@@ -273,7 +273,7 @@ class GetJobReplicaData:
     Phase: Optional[str] = None    # SDK常量: PhasePending, PhaseStarting, PhaseRunning, PhaseScanning, PhaseSucceeded, PhaseFailed, PhaseRestarting, PhaseStopped, PhaseInqueue, PhaseSelfHealTriggered, PhaseSelfHealRunning, PhaseSelfHealSucceeded, PhaseSelfHealFailed  json:"Phase,omitempty"
     PodIP: Optional[str] = ""    # Pod IP 地址  json:"PodIP,omitempty"
     RegionId: Optional[str] = ""    # 地域，从 Replica topology labels 读取；存量数据缺失时回填默认值 cn-shanghai  json:"RegionId,omitempty"
-    ReplicaIndex: Optional[int] = 0    # 副本序号  json:"ReplicaIndex,omitempty"
+    ReplicaIndex: Optional[str] = ""    # 副本序号  json:"ReplicaIndex,omitempty"
     TaskType: Optional[str] = ""    # 副本任务类型（如 worker）  json:"TaskType,omitempty"
     ZoneId: Optional[str] = ""    # 可用区，从 Replica topology labels 读取；存量数据缺失时回填默认值 cn-shanghai-b  json:"ZoneId,omitempty"
 

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

@@ -14,7 +14,11 @@ from .actions import (
     get_prewarm_pool,
     get_resource_stats,
     get_sandbox,
+    get_sandbox_egress_policy,
     get_sandbox_environment,
+    get_sandbox_logs_query_range,
+    get_sandbox_logs_volume_range,
+    list_environment_events,
     list_prewarm_pool_events,
     list_prewarm_pool_pods,
     list_sandbox_environments,
@@ -33,7 +37,11 @@ from .actions import (
     get_prewarm_pool_async,
     get_resource_stats_async,
     get_sandbox_async,
+    get_sandbox_egress_policy_async,
     get_sandbox_environment_async,
+    get_sandbox_logs_query_range_async,
+    get_sandbox_logs_volume_range_async,
+    list_environment_events_async,
     list_prewarm_pool_events_async,
     list_prewarm_pool_pods_async,
     list_sandbox_environments_async,
@@ -47,8 +55,10 @@ from .actions import (
 
 # Re-export models
 from .models import (
+    Action,
     ActualMode,
     AllocationMode,
+    DefaultAction,
     Kind,
     Level,
     Mode,
@@ -64,6 +74,9 @@ from .models import (
     CreateSandboxData,
     CreateSandboxEnvironmentReq,
     CreateSandboxReq,
+    EgressAlwaysRules,
+    EgressLogSkipRule,
+    EnvironmentEvent,
     EnvironmentInstanceCounts,
     EnvironmentResourceUsage,
     Image,
@@ -73,12 +86,18 @@ from .models import (
     CreateSandboxReqImageInput,
     CreateSandboxEnvironmentReqImageInput,
     GetInstanceStateStatsData,
+    ListEnvironmentEventsData,
     ListPrewarmPoolEventsData,
     ListPrewarmPoolPodsData,
     ListSandboxEnvironmentsData,
     ListSandboxProjectsData,
     ListSandboxesData,
     ModeInstanceStateCluster,
+    NetworkPolicy,
+    CreateSandboxReqNetworkPolicy,
+    NetworkRule,
+    CreateSandboxReqNetworkRule,
+    NodeCapacitySummary,
     Port,
     CreateSandboxReqPort,
     CreateSandboxEnvironmentReqPort,
@@ -90,6 +109,7 @@ from .models import (
     Resources,
     CreateSandboxReqResources,
     CreateSandboxEnvironmentReqResources,
+    GetSandboxEgressPolicyData,
     SandboxEndpointInfo,
     SandboxEndpoints,
     DeleteSandboxEnvironmentReq,
@@ -97,6 +117,12 @@ from .models import (
     DeleteSandboxReq,
     StopSandboxReq,
     GetSandboxData,
+    SandboxLogEntry,
+    SandboxLogVolumeDataPoint,
+    SandboxLogVolumeMetadata,
+    SandboxLogVolumeResult,
+    GetSandboxLogsQueryRangeData,
+    GetSandboxLogsVolumeRangeData,
     StateStatus,
     UpdateInstanceCapacityReq,
     UpdatePrewarmSizeReq,
@@ -118,7 +144,11 @@ from .models import (
     GetPrewarmPoolReq,
     GetResourceStatsReq,
     GetSandboxReq,
+    GetSandboxEgressPolicyReq,
     GetSandboxEnvironmentReq,
+    GetSandboxLogsQueryRangeReq,
+    GetSandboxLogsVolumeRangeReq,
+    ListEnvironmentEventsReq,
     ListPrewarmPoolEventsReq,
     ListPrewarmPoolPodsReq,
     ListSandboxEnvironmentsReq,

{yicloud_sdk_python-0.4.1 → yicloud_sdk_python-0.4.2}/yicloud/services/sandbox/actions.py

@@ -217,7 +217,7 @@ async def get_prewarm_pool_async(ctx: Optional[dict], req: models.GetPrewarmPool
 
 def get_resource_stats(ctx: Optional[dict], req: models.GetResourceStatsReq) -> models.GetResourceStatsData:
     """资源统计
-    查询指定沙盒环境下沙盒实例使用的 CPU 和内存资源。
+    查询指定沙盒环境的 CPU、内存用量，并返回集群沙盒节点池的总量、已用量和真实可调度剩余容量。旧版后端未提供节点容量时不返回 Node。
     GET /sandbox/v1alpha1/GetResourceStats
     Action: GetResourceStats
 
@@ -232,7 +232,7 @@ def get_resource_stats(ctx: Optional[dict], req: models.GetResourceStatsReq) ->
 
 async def get_resource_stats_async(ctx: Optional[dict], req: models.GetResourceStatsReq) -> models.GetResourceStatsData:
     """资源统计（异步）
-    查询指定沙盒环境下沙盒实例使用的 CPU 和内存资源。
+    查询指定沙盒环境的 CPU、内存用量，并返回集群沙盒节点池的总量、已用量和真实可调度剩余容量。旧版后端未提供节点容量时不返回 Node。
     GET /sandbox/v1alpha1/GetResourceStats
     Action: GetResourceStats
 
@@ -275,6 +275,36 @@ async def get_sandbox_async(ctx: Optional[dict], req: models.GetSandboxReq) -> m
     return rsp.get_typed_data()
 
 
+def get_sandbox_egress_policy(ctx: Optional[dict], req: models.GetSandboxEgressPolicyReq) -> models.GetSandboxEgressPolicyData:
+    """实例出站策略
+    查询已启用 egress 的实例当前策略及平台规则；实例未启用 egress 或 sidecar 不可用时返回上游错误。
+    GET /sandbox/v1alpha1/GetSandboxEgressPolicy
+    Action: GetSandboxEgressPolicy
+
+    Returns GetSandboxEgressPolicyData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxEgressPolicy"
+    rsp = msgs.Rsp[models.GetSandboxEgressPolicyData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def get_sandbox_egress_policy_async(ctx: Optional[dict], req: models.GetSandboxEgressPolicyReq) -> models.GetSandboxEgressPolicyData:
+    """实例出站策略（异步）
+    查询已启用 egress 的实例当前策略及平台规则；实例未启用 egress 或 sidecar 不可用时返回上游错误。
+    GET /sandbox/v1alpha1/GetSandboxEgressPolicy
+    Action: GetSandboxEgressPolicy
+
+    Returns GetSandboxEgressPolicyData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxEgressPolicy"
+    rsp = msgs.Rsp[models.GetSandboxEgressPolicyData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
 def get_sandbox_environment(ctx: Optional[dict], req: models.GetSandboxEnvironmentReq) -> models.GetSandboxEnvironmentData:
     """环境详情
     查询单个沙盒环境详情。
@@ -305,6 +335,96 @@ async def get_sandbox_environment_async(ctx: Optional[dict], req: models.GetSand
     return rsp.get_typed_data()
 
 
+def get_sandbox_logs_query_range(ctx: Optional[dict], req: models.GetSandboxLogsQueryRangeReq) -> models.GetSandboxLogsQueryRangeData:
+    """实例日志
+    查询指定沙盒实例的 Loki 日志；StartTime 和 EndTime 使用 Unix 秒整数，查询区间为 [StartTime, EndTime)。
+    GET /sandbox/v1alpha1/GetSandboxLogsQueryRange
+    Action: GetSandboxLogsQueryRange
+
+    Returns GetSandboxLogsQueryRangeData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxLogsQueryRange"
+    rsp = msgs.Rsp[models.GetSandboxLogsQueryRangeData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def get_sandbox_logs_query_range_async(ctx: Optional[dict], req: models.GetSandboxLogsQueryRangeReq) -> models.GetSandboxLogsQueryRangeData:
+    """实例日志（异步）
+    查询指定沙盒实例的 Loki 日志；StartTime 和 EndTime 使用 Unix 秒整数，查询区间为 [StartTime, EndTime)。
+    GET /sandbox/v1alpha1/GetSandboxLogsQueryRange
+    Action: GetSandboxLogsQueryRange
+
+    Returns GetSandboxLogsQueryRangeData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxLogsQueryRange"
+    rsp = msgs.Rsp[models.GetSandboxLogsQueryRangeData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+def get_sandbox_logs_volume_range(ctx: Optional[dict], req: models.GetSandboxLogsVolumeRangeReq) -> models.GetSandboxLogsVolumeRangeData:
+    """实例日志量
+    查询指定沙盒实例的日志量时序分布；StartTime 和 EndTime 使用 Unix 秒整数，查询区间为 [StartTime, EndTime)。
+    GET /sandbox/v1alpha1/GetSandboxLogsVolumeRange
+    Action: GetSandboxLogsVolumeRange
+
+    Returns GetSandboxLogsVolumeRangeData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxLogsVolumeRange"
+    rsp = msgs.Rsp[models.GetSandboxLogsVolumeRangeData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def get_sandbox_logs_volume_range_async(ctx: Optional[dict], req: models.GetSandboxLogsVolumeRangeReq) -> models.GetSandboxLogsVolumeRangeData:
+    """实例日志量（异步）
+    查询指定沙盒实例的日志量时序分布；StartTime 和 EndTime 使用 Unix 秒整数，查询区间为 [StartTime, EndTime)。
+    GET /sandbox/v1alpha1/GetSandboxLogsVolumeRange
+    Action: GetSandboxLogsVolumeRange
+
+    Returns GetSandboxLogsVolumeRangeData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/GetSandboxLogsVolumeRange"
+    rsp = msgs.Rsp[models.GetSandboxLogsVolumeRangeData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+def list_environment_events(ctx: Optional[dict], req: models.ListEnvironmentEventsReq) -> models.ListEnvironmentEventsData:
+    """环境事件
+    查询指定沙盒环境关联的实时 Kubernetes 事件；该接口不替代预热池历史事件查询。
+    GET /sandbox/v1alpha1/ListEnvironmentEvents
+    Action: ListEnvironmentEvents
+
+    Returns ListEnvironmentEventsData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListEnvironmentEvents"
+    rsp = msgs.Rsp[models.ListEnvironmentEventsData]()
+    client.base.get(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
+async def list_environment_events_async(ctx: Optional[dict], req: models.ListEnvironmentEventsReq) -> models.ListEnvironmentEventsData:
+    """环境事件（异步）
+    查询指定沙盒环境关联的实时 Kubernetes 事件；该接口不替代预热池历史事件查询。
+    GET /sandbox/v1alpha1/ListEnvironmentEvents
+    Action: ListEnvironmentEvents
+
+    Returns ListEnvironmentEventsData on success. 
+    Raises YiCloudException on error.
+    """
+    path = f"/{_PRODUCT_CODE}/{_LAST_VERSION}/ListEnvironmentEvents"
+    rsp = msgs.Rsp[models.ListEnvironmentEventsData]()
+    await client.base.get_async(ctx, path, req, rsp)
+    return rsp.get_typed_data()
+
+
 def list_prewarm_pool_events(ctx: Optional[dict], req: models.ListPrewarmPoolEventsReq) -> models.ListPrewarmPoolEventsData:
     """预热事件
     查询指定沙盒环境的预热池事件历史。

{yicloud_sdk_python-0.4.1 → yicloud_sdk_python-0.4.2}/yicloud/services/sandbox/models.py

@@ -4,6 +4,11 @@ from __future__ import annotations
 from dataclasses import dataclass, field
 from typing import Optional, List, Dict
 
+# Action 枚举值
+class Action:
+    ActionAllow = "allow"
+    ActionDeny = "deny"
+
 # ActualMode 枚举值
 class ActualMode:
     ActualModePool = "pool"
@@ -14,6 +19,11 @@ class AllocationMode:
     AllocationModePrewarm = "prewarm"
     AllocationModeManual = "manual"
 
+# DefaultAction 枚举值
+class DefaultAction:
+    DefaultActionAllow = "allow"
+    DefaultActionDeny = "deny"
+
 # Kind 枚举值
 class Kind:
     KindPool = "Pool"
@@ -137,11 +147,31 @@ class CreateSandboxReq:
     Image: Optional[CreateSandboxReqImageInput] = None    # Image 直接创建实例时使用的镜像配置;可使用 Uri,也可使用 Ref 并按需指定 Source 由 adapter 解析 registry host;Ref 和 Uri 必须二选一。  json:"Image,omitempty"
     LifecycleMinutes: Optional[int] = None    # LifecycleMinutes 实例生命周期,单位分钟。  json:"LifecycleMinutes,omitempty"
     Name: Optional[str] = None    # Name 沙盒实例名称。  json:"Name,omitempty"
+    NetworkPolicy: Optional[CreateSandboxReqNetworkPolicy] = None    # NetworkPolicy 实例出站策略；传入（包括空对象）会冷启动，不使用预热实例。省略则不启用。  json:"NetworkPolicy,omitempty"
     Ports: Optional[List[CreateSandboxReqPort]] = None    # Ports 实例端口暴露配置。  json:"Ports,omitempty"
     RequestTimeoutSeconds: Optional[int] = None    # RequestTimeoutSeconds 单次请求超时时间,单位秒。  json:"RequestTimeoutSeconds,omitempty"
     Resources: Optional[CreateSandboxReqResources] = None    # Resources 直接创建实例时使用的资源规格。  json:"Resources,omitempty"
     Volumes: Optional[List[CreateSandboxReqVolume]] = None    # Volumes 实例挂载卷配置。  json:"Volumes,omitempty"
 
+@dataclass
+class EgressAlwaysRules:
+    Allow: Optional[List[NetworkRule]] = None    # json:"Allow,omitempty"
+    Deny: Optional[List[NetworkRule]] = None    # json:"Deny,omitempty"
+    LogSkip: Optional[List[EgressLogSkipRule]] = None    # json:"LogSkip,omitempty"
+
+@dataclass
+class EgressLogSkipRule:
+    Target: Optional[str] = ""    # json:"Target,omitempty"
+
+@dataclass
+class EnvironmentEvent:
+    Kind: Optional[str] = ""    # Kind 关联 Kubernetes 对象类型。  json:"Kind,omitempty"
+    Level: Optional[str] = ""    # Level Kubernetes Event 类型。  json:"Level,omitempty"
+    Message: Optional[str] = ""    # Message 事件详情。  json:"Message,omitempty"
+    Name: Optional[str] = ""    # Name 关联 Kubernetes 对象名称。  json:"Name,omitempty"
+    Reason: Optional[str] = ""    # Reason 事件原因。  json:"Reason,omitempty"
+    Time: Optional[str] = ""    # Time 事件发生时间。  json:"Time,omitempty"
+
 @dataclass
 class EnvironmentInstanceCounts:
     Allocated: Optional[int] = 0    # Allocated 已分配实例数。  json:"Allocated,omitempty"
@@ -198,6 +228,13 @@ class GetInstanceStateStatsData:
     Prewarm: Optional[ModeInstanceStateCluster] = None    # Prewarm 预热实例状态统计。  json:"Prewarm,omitempty"
     UsedPercentage: Optional[int] = 0    # UsedPercentage 容量使用百分比。  json:"UsedPercentage,omitempty"
 
+@dataclass
+class ListEnvironmentEventsData:
+    Items: Optional[List[EnvironmentEvent]] = None    # Items 沙盒环境事件列表。  json:"Items,omitempty"
+    Limit: Optional[int] = 0    # Limit 本次响应对应的返回条数。  json:"Limit,omitempty"
+    Offset: Optional[int] = 0    # Offset 本次响应对应的偏移量。  json:"Offset,omitempty"
+    Total: Optional[int] = 0    # Total 符合条件的事件总数。  json:"Total,omitempty"
+
 @dataclass
 class ListPrewarmPoolEventsData:
     Items: Optional[List[PrewarmPoolEvent]] = None    # Items 预热池事件列表。  json:"Items,omitempty"
@@ -238,6 +275,38 @@ class ModeInstanceStateCluster:
     Terminating: Optional[int] = 0    # Terminating 终止中的实例数。  json:"Terminating,omitempty"
     Total: Optional[int] = 0    # Total 当前模式下实例总数。  json:"Total,omitempty"
 
+@dataclass
+class NetworkPolicy:
+    DefaultAction: Optional[str] = None    # SDK常量: DefaultActionAllow, DefaultActionDeny  json:"DefaultAction,omitempty"
+    Egress: Optional[List[NetworkRule]] = None    # json:"Egress,omitempty"
+
+@dataclass
+class CreateSandboxReqNetworkPolicy:
+    DefaultAction: Optional[str] = None    # SDK常量: DefaultActionAllow, DefaultActionDeny  json:"DefaultAction,omitempty"
+    Egress: Optional[List[CreateSandboxReqNetworkRule]] = None    # json:"Egress,omitempty"
+
+@dataclass
+class NetworkRule:
+    Action: str    # SDK常量: ActionAllow, ActionDeny  json:"Action"
+    Target: str    # json:"Target"
+
+@dataclass
+class CreateSandboxReqNetworkRule:
+    Action: str    # SDK常量: ActionAllow, ActionDeny  json:"Action"
+    Target: str    # json:"Target"
+
+@dataclass
+class NodeCapacitySummary:
+    TotalCpuCores: Optional[float] = 0.0    # TotalCpuCores 可调度节点 allocatable CPU 合计，单位核。  json:"TotalCpuCores,omitempty"
+    TotalMemGi: Optional[float] = 0.0    # TotalMemGi 可调度节点 allocatable 内存合计，单位 Gi。  json:"TotalMemGi,omitempty"
+    TotalPods: Optional[int] = 0    # TotalPods 可调度节点 allocatable Pod 数合计。  json:"TotalPods,omitempty"
+    UsableCpuCores: Optional[float] = 0.0    # UsableCpuCores 可调度节点真实剩余 CPU，单位核。  json:"UsableCpuCores,omitempty"
+    UsableMemGi: Optional[float] = 0.0    # UsableMemGi 可调度节点真实剩余内存，单位 Gi。  json:"UsableMemGi,omitempty"
+    UsablePods: Optional[int] = 0    # UsablePods 可调度节点真实剩余 Pod 数。  json:"UsablePods,omitempty"
+    UsedCpuCores: Optional[float] = 0.0    # UsedCpuCores 可调度节点已用 CPU，单位核。  json:"UsedCpuCores,omitempty"
+    UsedMemGi: Optional[float] = 0.0    # UsedMemGi 可调度节点已用内存，单位 Gi。  json:"UsedMemGi,omitempty"
+    UsedPods: Optional[int] = 0    # UsedPods 可调度节点已用 Pod 数。  json:"UsedPods,omitempty"
+
 @dataclass
 class Port:
     ContainerPort: int    # ContainerPort 容器内端口。  json:"ContainerPort"
@@ -299,6 +368,7 @@ class GetResourceStatsData:
     CpuUsedCores: Optional[float] = 0.0    # CpuUsedCores 已使用 CPU 核数。  json:"CpuUsedCores,omitempty"
     MemoryQuotaGi: Optional[float] = 0.0    # MemoryQuotaGi 内存配额,单位 Gi。  json:"MemoryQuotaGi,omitempty"
     MemoryUsedGi: Optional[float] = 0.0    # MemoryUsedGi 已使用内存,单位 Gi。  json:"MemoryUsedGi,omitempty"
+    Node: Optional[NodeCapacitySummary] = None    # Node 集群沙盒节点池容量；旧版后端未提供该数据时省略。  json:"Node,omitempty"
 
 @dataclass
 class Resources:
@@ -315,6 +385,14 @@ class CreateSandboxEnvironmentReqResources:
     Cpu: str    # Cpu CPU 资源规格,例如 1 或 8。  json:"Cpu"
     Memory: str    # Memory 内存资源规格,例如 2Gi 或 8Gi。  json:"Memory"
 
+@dataclass
+class GetSandboxEgressPolicyData:
+    AlwaysRules: Optional[EgressAlwaysRules] = None    # json:"AlwaysRules,omitempty"
+    EnforcementMode: Optional[str] = ""    # json:"EnforcementMode,omitempty"
+    Mode: Optional[str] = ""    # json:"Mode,omitempty"
+    Policy: Optional[NetworkPolicy] = None    # json:"Policy,omitempty"
+    Status: Optional[str] = ""    # json:"Status,omitempty"
+
 @dataclass
 class SandboxEndpointInfo:
     ExternalUrl: Optional[str] = ""    # ExternalUrl 外部访问地址,可用性取决于网关和数据面配置。  json:"ExternalUrl,omitempty"
@@ -378,6 +456,7 @@ class GetSandboxData:
     CreatedAt: Optional[str] = ""    # CreatedAt 创建时间,RFC3339 格式。  json:"CreatedAt,omitempty"
     CreatorId: Optional[str] = ""    # CreatorId 创建人 ID。  json:"CreatorId,omitempty"
     CreatorName: Optional[str] = ""    # CreatorName 创建人名称。  json:"CreatorName,omitempty"
+    EgressEnabled: Optional[bool] = False    # EgressEnabled 是否注入出站管控 sidecar；当前规则通过 GetSandboxEgressPolicy 查询。  json:"EgressEnabled,omitempty"
     Endpoints: Optional[SandboxEndpoints] = None    # Endpoints 沙盒端口访问入口信息。  json:"Endpoints,omitempty"
     Entrypoint: Optional[List[str]] = None    # Entrypoint 实例启动命令。  json:"Entrypoint,omitempty"
     Env: Optional[Dict[str, str]] = None    # Env 实例环境变量。  json:"Env,omitempty"
@@ -401,6 +480,36 @@ class GetSandboxData:
     Type: Optional[str] = None    # SDK常量: TypeCode, TypeBrowser, TypeDesktop, TypeCustom  json:"Type,omitempty"
     Volumes: Optional[List[Volume]] = None    # Volumes 实例挂载卷配置。  json:"Volumes,omitempty"
 
+@dataclass
+class SandboxLogEntry:
+    Line: Optional[str] = ""    # Line 日志正文。  json:"Line,omitempty"
+    Timestamp: Optional[str] = ""    # Timestamp 日志时间戳，RFC3339 UTC；按日志实际精度保留小数秒。  json:"Timestamp,omitempty"
+
+@dataclass
+class SandboxLogVolumeDataPoint:
+    Count: Optional[str] = ""    # Count 该时间点的日志量；使用字符串避免数值精度损失。  json:"Count,omitempty"
+    Timestamp: Optional[str] = ""    # Timestamp 聚合时间点，秒级 RFC3339 UTC。  json:"Timestamp,omitempty"
+
+@dataclass
+class SandboxLogVolumeMetadata:
+    Step: Optional[int] = 0    # Step 聚合步长，单位秒。  json:"Step,omitempty"
+
+@dataclass
+class SandboxLogVolumeResult:
+    Metric: Optional[Dict[str, str]] = None    # Metric Loki 聚合结果的标签集合。  json:"Metric,omitempty"
+    Values: Optional[List[SandboxLogVolumeDataPoint]] = None    # Values 日志量时序数据点。  json:"Values,omitempty"
+
+@dataclass
+class GetSandboxLogsQueryRangeData:
+    Entries: Optional[List[SandboxLogEntry]] = None    # Entries 时间范围内的日志记录。  json:"Entries,omitempty"
+    SandboxId: Optional[str] = ""    # SandboxId 沙盒实例 ID。  json:"SandboxId,omitempty"
+
+@dataclass
+class GetSandboxLogsVolumeRangeData:
+    Metadata: Optional[SandboxLogVolumeMetadata] = None    # Metadata 查询元数据。  json:"Metadata,omitempty"
+    Result: Optional[List[SandboxLogVolumeResult]] = None    # Result 日志量时序结果。  json:"Result,omitempty"
+    SandboxId: Optional[str] = ""    # SandboxId 沙盒实例 ID。  json:"SandboxId,omitempty"
+
 @dataclass
 class StateStatus:
     LastTransitionAt: Optional[str] = ""    # LastTransitionAt 最近一次状态变更时间,RFC3339 格式。  json:"LastTransitionAt,omitempty"
@@ -522,11 +631,52 @@ class GetSandboxReq:
     ProjectName: str    # 项目 namespace  query:"ProjectName"
     SandboxId: str    # 沙盒实例 ID  query:"SandboxId"
 
+@dataclass
+class GetSandboxEgressPolicyReq:
+    ProjectName: str    # 项目 namespace  query:"ProjectName"
+    SandboxId: str    # 沙盒实例 ID  query:"SandboxId"
+
 @dataclass
 class GetSandboxEnvironmentReq:
     EnvironmentId: str    # 沙盒环境 ID  query:"EnvironmentId"
     ProjectName: str    # 项目 namespace  query:"ProjectName"
 
+@dataclass
+class GetSandboxLogsQueryRangeReq:
+    ProjectName: str    # 项目 namespace  query:"ProjectName"
+    SandboxId: str    # 沙盒实例 ID  query:"SandboxId"
+    StartTime: int    # 查询起始时间，Unix 秒整数  query:"StartTime"
+    CaseSensitive: Optional[bool] = None    # 关键词匹配是否区分大小写  query:"CaseSensitive,omitempty"
+    Cluster: Optional[str] = None    # Loki 集群标签；不传时使用 brainbox 默认配置  query:"Cluster,omitempty"
+    Direction: Optional[str] = None    # 查询方向  query:"Direction,omitempty"
+    EndTime: Optional[int] = None    # 查询结束时间，Unix 秒整数；不传时使用 brainbox 当前时间  query:"EndTime,omitempty"
+    Keyword: Optional[str] = None    # 日志关键词  query:"Keyword,omitempty"
+    Limit: Optional[int] = None    # 最大返回条数  query:"Limit,omitempty"
+    Regex: Optional[bool] = None    # 是否将 Keyword 作为正则表达式  query:"Regex,omitempty"
+
+@dataclass
+class GetSandboxLogsVolumeRangeReq:
+    ProjectName: str    # 项目 namespace  query:"ProjectName"
+    SandboxId: str    # 沙盒实例 ID  query:"SandboxId"
+    StartTime: int    # 查询起始时间，Unix 秒整数  query:"StartTime"
+    CaseSensitive: Optional[bool] = None    # 关键词匹配是否区分大小写  query:"CaseSensitive,omitempty"
+    Cluster: Optional[str] = None    # Loki 集群标签；不传时使用 brainbox 默认配置  query:"Cluster,omitempty"
+    EndTime: Optional[int] = None    # 查询结束时间，Unix 秒整数；不传时使用 brainbox 当前时间  query:"EndTime,omitempty"
+    Keyword: Optional[str] = None    # 日志关键词  query:"Keyword,omitempty"
+    Limit: Optional[int] = None    # 最大返回条数  query:"Limit,omitempty"
+    Regex: Optional[bool] = None    # 是否将 Keyword 作为正则表达式  query:"Regex,omitempty"
+    Step: Optional[str] = None    # 聚合步长，Go duration 格式；不传时由 brainbox 自动计算  query:"Step,omitempty"
+
+@dataclass
+class ListEnvironmentEventsReq:
+    EnvironmentId: str    # 沙盒环境 ID  query:"EnvironmentId"
+    ProjectName: str    # 项目 namespace  query:"ProjectName"
+    Kind: Optional[str] = None    # Kubernetes 对象类型  query:"Kind,omitempty"
+    Level: Optional[str] = None    # Kubernetes Event 类型 SDK常量: LevelNormal, LevelWarning  query:"Level,omitempty"
+    Limit: Optional[int] = None    # 返回条数  query:"Limit,omitempty"
+    Offset: Optional[int] = None    # 偏移量  query:"Offset,omitempty"
+    Since: Optional[str] = None    # RFC3339 起始时间；不传时使用 brainbox 默认时间窗  query:"Since,omitempty"
+
 @dataclass
 class ListPrewarmPoolEventsReq:
     EnvironmentId: str    # 沙盒环境 ID  query:"EnvironmentId"

{yicloud_sdk_python-0.4.1 → yicloud_sdk_python-0.4.2}/yicloud/services/workspace/actions.py

@@ -585,7 +585,7 @@ async def get_release_exclude_patterns_async(ctx: Optional[dict], req: models.Ge
 
 def release_process(ctx: Optional[dict], req: models.ReleaseProcessReq):
     """制作镜像
-    将指定进程的当前环境制作为容器镜像
+    将指定进程的当前环境制作为容器镜像。操作者用户 ID 从请求头 X-Kb-Subject 获取（网关鉴权后注入，必填），用于记录提交镜像的操作者信息，缺失时返回参数错误
     POST /workspace/v1alpha1/ReleaseProcess
     Action: ReleaseProcess
 
@@ -599,7 +599,7 @@ def release_process(ctx: Optional[dict], req: models.ReleaseProcessReq):
 
 async def release_process_async(ctx: Optional[dict], req: models.ReleaseProcessReq):
     """制作镜像（异步）
-    将指定进程的当前环境制作为容器镜像
+    将指定进程的当前环境制作为容器镜像。操作者用户 ID 从请求头 X-Kb-Subject 获取（网关鉴权后注入，必填），用于记录提交镜像的操作者信息，缺失时返回参数错误
     POST /workspace/v1alpha1/ReleaseProcess
     Action: ReleaseProcess
 

{yicloud_sdk_python-0.4.1 → yicloud_sdk_python-0.4.2}/yicloud/services/workspace/models.py

@@ -51,6 +51,8 @@ class BatchStopWorkspacesData:
 @dataclass
 class CommitHistoryResponse:
     CommitTime: Optional[str] = ""    # 制作时间（RFC3339 格式）  json:"CommitTime,omitempty"
+    Creator: Optional[str] = ""    # 制作镜像的操作者用户名  json:"Creator,omitempty"
+    CreatorId: Optional[str] = ""    # 制作镜像的操作者用户 ID  json:"CreatorId,omitempty"
     Description: Optional[str] = ""    # 描述  json:"Description,omitempty"
     ErrorMsg: Optional[str] = ""    # 错误信息  json:"ErrorMsg,omitempty"
     Image: Optional[str] = ""    # 镜像地址  json:"Image,omitempty"

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

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