uip 解决方案包

“uip 解决方案包”的语法和选项，用于列出、下载和删除已发布的解决方案包。

uip solution packages管理已发布的解决方案包— 由uip solution pack生成并由uip solution publish上传的.zip工件。

子命令	用途
list	列出已发布的包（名称、版本、发布日期）。
download	将已发布的包 .zip 下载到磁盘。
delete	删除已发布包的特定版本。

系统将对所有三个子命令进行身份验证。请先运行uip login 。list 、 download和delete分别默认为租户订阅源；传递--personal-workspace或--feed <name-or-key> （仅列出/删除）以定位其他目标。

大纲

uip solution packages list [--limit <n>] [--offset <n>] [--sort-by <column>] [--sort-order <Ascending|Descending>] [--name <pattern>] [--personal-workspace | --feed <name-or-key>]
uip solution packages download <packageName> [packageVersion] [--package-version <version>] [-d <destination>]
uip solution packages delete <packageName> <packageVersion> --yes [--personal-workspace | --feed <name-or-key>]

每个子命令都遵循全局选项，并返回标准退出代码。

---

UIP 解决方案包列表

列出已发布到订阅源的解决方案包。输出包含您需要传递给uip solution deploy run字段： packageName和packageVersion 。

选项

长	值	默认	描述
-l, --limit <number>	数字	50	要返回的包数。
--offset <number>	数字	0	要跳过的包数量。
--sort-by <column>	text	publishDate	要排序的列。
--sort-order <direction>	Ascending | Descending	Descending	排序方向
--name <pattern>	text	—	包名称的服务器端子字符串匹配。
--personal-workspace	标记	关闭	仅列出当前用户的个人工作区订阅源中的包。与 --feed 互斥。
--feed <name-or-key>	text	—	仅列出此订阅源中的包（来自solution feeds list名称或文件夹键）。与 --personal-workspace 互斥。
--login-validity <minutes>	分钟	10	在令牌过期前触发刷新的最短分钟数。

示例

# Most-recent publish in the tenant feed
uip solution packages list --limit 1

# Packages matching a name in a specific feed
uip solution packages list --feed Finance --name my-package

# Pick the latest version of a known package
uip solution packages list --output-filter "Data[?packageName=='my-package'] | [0].packageVersion" --output plain

数据形状（--输出 json）

{
  "Code": "SolutionPackagesList",
  "Data": [
    {
      "packageName": "MyPackage",
      "packageVersion": "1.0.0",
      "publishDate": "2026-04-15T10:30:00Z"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 10, "Offset": 0, "Total": 1 }
}

---

uip 解决方案包下载

从订阅源下载已发布的包 .zip。包必须为 Ready 或 Active。

参数

• <package-name> （必填） — 解决方案包名称。使用packages list查找可用名称。
• [package-version] （可选） — 要下载的版本。也可与 --package-version 一起提供；为两者提供不同的值将是错误的。如果省略，则使用最新版本。

选项

长	值	默认	描述
--package-version <version>	text	最新	位置参数的替代方法。
-d, --destination <path>	路径	当前目录	本地 .zip 文件路径或目录。结尾斜杠 . 或现有目录被视为目录，并附加默认文件名 <name>.<version>.zip；否则，该路径将用作确切的输出文件。
--login-validity <minutes>	分钟	10	在令牌过期前触发刷新的最短分钟数。

示例

# Default filename in the current directory
uip solution packages download my-solution 1.0.0

# Latest version, specific output file
uip solution packages download my-solution -d ./out/my-solution.zip

# Promote a package across tenants: download from staging, publish to dev
uip login tenant set staging
uip solution packages download my-solution 1.0.0 -d ./out/my-solution_1.0.0.zip
uip login tenant set dev
uip solution publish ./out/my-solution_1.0.0.zip

数据形状（--输出 json）

{
  "Code": "SolutionPackagesDownload",
  "Data": {
    "Status": "Package downloaded",
    "PackageName": "my-solution",
    "PackageVersion": "1.0.0",
    "State": "Ready",
    "OutputPath": "./my-solution.1.0.0.zip",
    "FileName": "./my-solution.1.0.0.zip",
    "Size": 254318
  }
}

故障模式

• 包未处于Ready / Active状态。Pending 包失败，并显示等待并重试的说明；任何其他非就绪状态都指向回退再次发布包。
• 冲突版本。拒绝同时传递具有不同值的位置[package-version]和--package-version。

---

UIP 解决方案包删除

从订阅源中删除已发布包的特定版本。这是一项永久性操作，无法软删除。

参数

• <packageName> （必填） — 包名称，由packages list返回。
• <packageVersion> （必填） — 要删除的确切版本（例如1.0.0 ）。

选项

长	值	默认	描述
-y, --yes	标记	—	必需。确认此不可撤销的操作 — CLI 从不提示。
--personal-workspace	标记	关闭	从当前用户的个人工作区订阅源中删除包版本。与 --feed 互斥。
--feed <name-or-key>	text	—	删除此订阅源中的包版本（名称或文件夹键）。与 --personal-workspace 互斥。
--login-validity <minutes>	分钟	10	在令牌过期前触发刷新的最短分钟数。

示例

uip solution packages delete my-package 1.0.0 --yes

# Delete all versions older than a given major
uip solution packages list --limit 100 \
  --output-filter "Data[?packageName=='my-package' && starts_with(packageVersion, '0.')]" \
  --output json \
  | jq -r '.[] | .packageVersion' \
  | xargs -I{} uip solution packages delete my-package {} --yes

数据形状（--输出 json）

{
  "Code": "SolutionPackagesDelete",
  "Data": {
    "PackageName": "my-package",
    "PackageVersion": "1.0.0"
  }
}

故障模式

• 缺少-y, --yes 。命令在未确认的情况下拒绝 — 这不是提示词，而是硬性要求。
• 未找到包或版本。显示为标准故障，并根据 packages list 验证名称和版本的说明（范围为同一 --personal-workspace/--feed，如果使用）。
• 权限不足。经过身份验证的用户必须有权删除目标订阅源中的包。

---

相关命令

• uip solution pack — 生成最终在订阅源中的.zip文件。
• uip solution publish — 将打包的.zip上传到订阅源（请参阅“版本冲突处理”）。
• uip solution feeds list — 查找--feed的订阅源名称或密钥。
• uip solution deploy run — 将已发布的包部署到 Orchestrator。

另请参阅

• 身份验证。
• uip solution概述。