uip IXP 部署

“uip IXP 部署”的语法和选项，可将经过训练的 IXP 模型版本部署到 Orchestrator 文件夹并管理现有部署。

uip ixp deployments 将经过训练的模型版本部署到 Orchestrator 文件夹，从而使其可以在运行时由活动和 Maestro Flow 调用；将现有部署移动到另一个版本；并检查固定到特定版本的分类。有关部署与发布模型版本的关系，请参阅父页面上的“概念” 。

大纲

uip ixp deployments create <project-name> --version <n> --folder-key <guid> [--title <title>]
uip ixp deployments upgrade <project-name> <deployment-name> --version <n> --folder-key <guid>
uip ixp deployments list <project-name>
uip ixp deployments get-taxonomy <project-name> --version <n>

uip IXP 部署创建

将经过训练的模型版本部署到 Orchestrator 文件夹中。仅限添加部署 — 将现有部署移动到其他版本是deployments upgrade 。

参数

名称	必填	用途
<project-name>	是	项目名称。

选项

长	值	必填	描述
--version <number>	非负整数	是	要部署的已训练模型版本。从projects list-models获取可用版本
--folder-key <guid>	GUID	是	要部署到的 Orchestrator 文件夹密钥。从 uip or folders list --output json 获取。
--title <title>	字符串	否	要在其中部署的标题。默认为项目名称减去其 -ixp 后缀。作为 DeploymentTitle 原义返回；后端缩略名并将其作为运行时解析的名称后缀，返回为 DeploymentName。

来自后端的 409 冲突（项目在该文件夹中已存在部署）会通过提示指向您 deployments upgrade — 使用相同参数重新运行 create 的简单重试会返回 404 错误，因为upgrade 按 DeploymentName 解决部署，而不是您传递的标题。

示例

uip ixp deployments create my-invoices-a1b2c3d4-ixp --version 13 \
  --folder-key 3f0a91c7-1111-2222-3333-444455556666

uip ixp deployments create my-invoices-a1b2c3d4-ixp --version 13 \
  --folder-key 3f0a91c7-1111-2222-3333-444455556666 --title invoices

数据形状（--输出 json）

{
  "Code": "IxpDeploymentsCreate",
  "Data": {
    "ProjectName": "my-invoices-a1b2c3d4-ixp",
    "ModelVersion": 13,
    "FolderKey": "3f0a91c7-1111-2222-3333-444455556666",
    "DeploymentName": "my-invoices-a1b2c3d4-7c3f21e8-ixp",
    "DeploymentTitle": "my-invoices-a1b2c3d4"
  }
}

DeploymentName 始终以生成的 ID 为后缀，而不仅仅是项目名称或标题，即使省略了 --title 也如此。

uip IXP 部署升级

将现有部署移动到另一个经过训练的模型版本，从而更改该文件夹和名称的每个 Runtime 调用者获取的版本。

参数

名称	必填	用途
<project-name>	是	项目名称。
<deployment-name>	是	要移动的部署，按运行时解析的名称编址 — deployments list的DeploymentName字段，而不是创建时的标题。

选项

长	值	必填	描述
--version <number>	非负整数	是	要将部署移动到的经过训练的模型版本。
--folder-key <guid>	GUID	是	托管部署的 Orchestrator 文件夹密钥。可以在多个文件夹中部署相同的名称，因此该文件夹是部署标识的一部分。

示例

uip ixp deployments upgrade my-invoices-a1b2c3d4-ixp invoices-08963f00-ixp \
  --version 14 --folder-key 3f0a91c7-1111-2222-3333-444455556666

数据形状（--输出 json）

{
  "Code": "IxpDeploymentsUpgrade",
  "Data": {
    "ProjectName": "my-invoices-a1b2c3d4-ixp",
    "ModelVersion": 14,
    "FolderKey": "3f0a91c7-1111-2222-3333-444455556666",
    "DeploymentName": "invoices-08963f00-ixp",
    "DeploymentTitle": "invoices"
  }
}

uip IXP 部署列表

列出项目的模型部署，跨每个版本以及已部署的文件夹。

参数

名称	必填	用途
<project-name>	是	项目名称。

示例

uip ixp deployments list my-invoices-a1b2c3d4-ixp

数据形状（--输出 json）

{
  "Code": "IxpDeploymentsList",
  "Data": [
    {
      "DeploymentName": "invoices-08963f00-ixp",
      "DeploymentTitle": "invoices",
      "ModelVersion": 13,
      "FolderKey": "3f0a91c7-1111-2222-3333-444455556666",
      "DeployedAt": "2026-08-18T11:26:25.367124+00:00"
    }
  ]
}

uip IXP 部署获取分类

获取特定经过训练的模型版本的项目分类（数据类型 + 字段组），即为该部署模型提供支持的架构。

参数

名称	必填	用途
<project-name>	是	项目名称。

选项

长	值	必填	描述
--version <number>	非负整数	是	已训练的模型版本。从 projects list-models 中获取可用版本。

示例

uip ixp deployments get-taxonomy my-invoices --version 13 --output json

数据形状（--输出 json）

{
  "Code": "IxpDeploymentsGetTaxonomy",
  "Data": { "dataset": { "entity_defs": [], "label_groups": [] } }
}

Data 以后端的原始 Snake 命名法（而非帕斯卡拼写法）进行原义转发。

相关内容

• uip IXP — 概念和完整资源目录。
• UIP IXP 项目— publish / list-models ，以生成此页面部署的版本号。

另请参阅

• IXP 工具概述
• 全局选项
• 退出代码