0 / 0
Go back to the English version of the documentation
更新部署
Last updated: 2024年11月21日
更新部署

创建联机或批处理部署后,仍可以更新部署详细信息并更新与部署关联的资产。

有关更多信息,请参阅:

更新部署详细信息

您可以使用下列其中一种方法来更新常规部署详细信息,例如部署名称,描述,元数据和标记:

准备工作

您必须通过生成 API 密钥来设置任务凭证。 有关更多信息,请参阅管理任务凭证

从 UI 更新部署详细信息

  1. 从部署空间的 部署 选项卡中,单击部署的操作菜单,然后选择 编辑设置

  2. 更新详细信息,然后单击 保存

    提示:您也可以从该部署的信息工作表更新部署。

使用补丁 API 命令更新部署详细信息

使用watsonx.aiRuntime API Patch命令更新部署详细信息。

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment id>?space_id=<space id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

例如,要更新部署的描述:

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment_id>?space_id=<space_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "replace",
        "path": "/description",
        "value": "<new_description>"
    },
]'

备注

  • 对于 <operation type>,请使用 "add""remove""replace"

更新与部署相关联的资产

创建联机部署或批量部署之后,可以从同一端点更新已部署的资产。 例如,如果有性能更好的模型,您可将已部署的模型替换为改良版本。 更新完成后,可从 REST API 端点获取新模型。

在更新资产之前,请确保满足以下条件:

从部署空间 UI 更新资产

  1. 从部署空间的 部署 选项卡中,单击部署的操作菜单,然后选择 编辑
  2. 单击 替换资产。 从 " 选择资产 " 对话框中,选择要将当前资产替换为的资产,然后单击 选择资产
  3. 单击保存
要点: 确保新资产与部署兼容。

替换已部署的资产

使用补丁 API 命令更新资产

使用watsonx.aiRuntimeAPI的 "Patch命令更新任何受支持的资产。

使用以下方法可修补联机部署的模型。

curl -X PATCH '<deployment endpoint url>/ml/v4/models/<model_id>?space_id=<space_id>&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

例如,在空间标识 f2ddb8ce-7b10-4846-9ab0-62454a449802 中使用标识 6f01d512-fe0f-41cd-9a52-1e200c525c84 为模型打补丁:

curl -X PATCH '<deployment endpoint url>/ml/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[

   {
      "op":"replace",
      "path":"/asset",
      "value":{
         "id":"6f01d512-fe0f-41cd-9a52-1e200c525c84",
         "rev":"1"
      }
   }
]'

成功的输出响应如下所示:

{
  "entity": {
    "asset": {
      "href": "/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "6f01d512-fe0f-41cd-9a52-1e200c525c84"
    },
    "custom": {
    },
    "description": "Test deployments",
    "name": "test_v4_dep_online_space_hardware_spec",
    "online": {
    },
    "space": {
      "href": "/v4/spaces/f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802",
    "status": {
      "online_url": {
        "url": "https://example.com/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83/predictions"
      },
      "state": "updating"
    }
  },
  "metadata": {
    "created_at": "2020-06-08T16:51:08.315Z",
    "description": "Test deployments",
    "guid": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "href": "/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83",
    "id": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "modified_at": "2020-06-08T16:55:28.348Z",
    "name": "test_v4_dep_online_space_hardware_spec",
    "parent": {
      "href": ""
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
  }
}

注:

  • 对于 <operation type>,请使用 "add""remove""replace"

  • PATCH API 输出的初始状态为 "正在更新"。 保持轮询状态,直到其更改为 "就绪" ,然后检索部署元。

  • 只能指定资产补丁的 ASSET 属性。 更改任何其他属性会导致错误。

  • 将当前模型和要修补的模型的模式与部署资产进行比较。 如果两者不匹配,那么将在补丁请求 API 的输出中返回一条警告消息。 例如,如果检测到不匹配,那么可以在输出响应中找到此信息。

    "status": {
          "message": {
            "text": "The input schema of the asset being patched does not match with the currently deployed asset. Please ensure that the score payloads are up to date as per the asset being patched."
          },
    
  • 有关更多信息,请参阅 使用 API 更新软件规范

父主题: 管理预测性部署

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more