调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateDeployment	要执行的操作，取值：UpdateDeployment。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
deployment_id	String	是	di-2100001281-69chb	要更新的无状态工作负载的ID。只有您手动创建的无状态工作负载（biz_line 取值为 0）允许编辑。如果无状态工作负载是因模型服务、设备驱动等创建的（即关联其他业务），则无法修改。您可以调用ListDeployment接口获取所有工作负载ID。
name	String	是	nginx-test	要更新的工作负载的名称。
deployment	Object	是		工作负载配置详情。
project_id	String	是	p-2100001281-zf9ll	工作负载所属边缘智能空间ID。您可以调用ListProject接口获取所有边缘智能空间ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
deployment_id	String	di-2100001281-69chb	工作负载ID。
project_id	String	p-2100001281-zf9ll	工作负载所属边缘智能空间ID。

请求示例

POST /?Action=UpdateDeployment&Version=2022-01-01 HTTP/1.1
Host: vei-api.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241008T075156Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241008/cn-beijing/vei_api/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "project_id": "p-2100001281-zf9ll",
  "deployment": {
    "replicas": 1,
    "template": {
      "containers": [
        {
          "name": "nginx",
          "image": "vei-public-cn-beijing.cr.volces.com/public/nginx",
          "resources": {
            "cpu_limit": 0,
            "cpu_request": 0,
            "memory_limit": 0,
            "memory_request": 0,
            "memory_request_unit": "GB",
            "memory_limit_unit": "GB"
          },
          "privileged": false,
          "inited": false,
          "device_mounted": false
        }
      ],
      "volumes": [],
      "dns_policy": 1
    },
    "strategy": {
      "strategy_type": 2,
      "rolling": {
        "max_unavailable": 25,
        "max_surge": 1
      }
    },
    "node_list": [
      ""
    ],
  },
  "name": "nginx-test",
  "deployment_id": "di-2100001281-69chb"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241008155214231191099019EA7C1D",
    "Action": "UpdateDeployment",
    "Version": "2022-01-01",
    "Service": "vei_api",
    "Region": "cn-beijing"
  },
  "Result": {
    "deployment_id": "di-2100001281-69chb",
    "project_id": "p-2100001281-zf9ll"
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	90000021	The account is not authorized to access project	越权访问其他账号下的空间。
400	20010001	Illegal.Param	参数非法。
400	20010002	ParamError.Account	账户信息无效。
400	20010003	ParamError.Project	空间信息无效。
400	20011011	IdInvalid.Workload	ID无效。
400	20011006	NameInvalid.Workload	名称无效。
400	20011007	ReplicasInvalid.Workload	副本数无效。
400	20011008	DescriptionInvalid.Workload	描述内容无效。
400	20011009	LabelsHciVersionNotSupported.Workload	当前一体机版本不支持标签，请使用OTA升级至v1.1.0或更高版本。
400	20011010	LabelsHciVersionNotSupported.Workload	当前一体机版本不支持实例字段，请使用OTA升级至v1.0.0或更高版本。
400	20011022	Nil.Workload	工作负载信息为空。
400	20011023	NilStrategy.Workload	工作负载更新策略为空。
400	20011025	LabelsInvalid.Workload	标签无效。
400	20011026	TemplateInvalid.Workload	template无效。
400	20011027	ContainerInvalid.Workload	容器配置无效。
400	20011028	ContainerNameInvalid.Workload	容器配置名称无效。
400	20011029	ContainerImagePathInvalid.Workload	容器配置镜像地址无效。
400	20011030	ResourceUnitInvalid.Workload	资源单位无效。
400	20011032	HostPortRangeInvalid.Workload	主机端口范围无效, 合法值为1-20000。
400	20011020	EnvInvalid.Pod	工作负载副本环境变量无效。
400	20011021	EnvNameInvalid.Pod	工作负载副本环境变量名称无效。
400	20011031	ResourceInvalid.Workload	资源无效。
400	20011033	MountPathDuplicated.Volume	挂载路径冲突。
400	20011034	VolumeNameDuplicated.Volume	卷名称冲突。
400	20011035	VolumeInvalid.Volume	挂载路径无效。
400	20010004	NotFound.Param	未找到。
500	20010006	ParamError.Internal	服务内部错误。

最近更新时间：2025.10.23 10:47:28

这个页面对您有帮助吗？

有用

无用

边缘智能

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码