更新AddonInstance
功能介绍
更新插件实例的功能。
调试
您可以在API Explorer中调试该接口。
URI
PUT /api/v3/addons/{id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
是 |
String |
插件实例id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式) |
X-Auth-Token |
是 |
String |
调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
kind |
是 |
String |
API类型,固定值“Addon”,该值不可修改。 |
apiVersion |
是 |
String |
API版本,固定值“v3”,该值不可修改。 |
metadata |
是 |
Metadata object |
基本信息,为集合类的元素类型,包含一组由不同名称定义的属性 |
spec |
是 |
InstanceRequestSpec object |
spec是集合类的元素类型,内容为插件实例安装/升级的具体请求信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
uid |
否 |
String |
唯一id标识 |
name |
否 |
String |
插件名称 |
labels |
否 |
Map<String,String> |
插件标签,key/value对格式,接口保留字段,填写不会生效 |
annotations |
否 |
Map<String,String> |
插件注解,由key/value组成
|
updateTimestamp |
否 |
String |
更新时间 |
creationTimestamp |
否 |
String |
创建时间 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
kind |
String |
API类型,固定值“Addon”,该值不可修改。 |
apiVersion |
String |
API版本,固定值“v3”,该值不可修改。 |
metadata |
Metadata object |
基本信息,为集合类的元素类型,包含一组由不同名称定义的属性 |
spec |
InstanceSpec object |
spec是集合类的元素类型,内容为插件实例具体信息,实例的详细描述主体部分都在spec中给出 |
status |
AddonInstanceStatus object |
插件实例状态 |
参数 |
参数类型 |
描述 |
---|---|---|
uid |
String |
唯一id标识 |
name |
String |
插件名称 |
labels |
Map<String,String> |
插件标签,key/value对格式,接口保留字段,填写不会生效 |
annotations |
Map<String,String> |
插件注解,由key/value组成
|
updateTimestamp |
String |
更新时间 |
creationTimestamp |
String |
创建时间 |
参数 |
参数类型 |
描述 |
---|---|---|
clusterID |
String |
集群id |
version |
String |
插件模板版本号,如1.0.0 |
addonTemplateName |
String |
插件模板名称,如coredns |
addonTemplateType |
String |
插件模板类型 |
addonTemplateLogo |
String |
插件模板logo图片的地址 |
addonTemplateLabels |
Array of strings |
插件模板所属类型 |
description |
String |
插件模板描述 |
values |
Map<String,Object> |
插件模板安装参数(各插件不同),请根据具体插件模板信息填写安装参数。 |
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
插件实例状态 |
Reason |
String |
插件安装失败原因 |
message |
String |
安装错误详情 |
targetVersions |
Array of strings |
此插件版本,支持升级的集群版本 |
currentVersion |
Versions object |
当前插件实例使用的具体插件版本信息 |
参数 |
参数类型 |
描述 |
---|---|---|
version |
String |
插件版本号 |
input |
Object |
插件安装参数 |
stable |
Boolean |
是否为稳定版本 |
translate |
Object |
供界面使用的翻译信息 |
supportVersions |
Array of SupportVersions objects |
支持集群版本号 |
creationTimestamp |
String |
创建时间 |
updateTimestamp |
String |
更新时间 |
请求示例
{ "kind" : "Addon", "apiVersion" : "v3", "metadata" : { "annotations" : { "addon.upgrade/type" : "upgrade" } }, "spec" : { "addonTemplateName" : "autoscaler", "clusterID" : "ff3c18de-d9fe-11ea-ae03-0255ac100449", "values" : { "basic" : { "rbac_enabled" : true, "swr_addr" : "100.125.6.246:20202", "swr_user" : "hwofficial" } }, "version" : "1.17.2" } }
响应示例
状态码: 200
OK
{ "kind" : "Addon", "apiVersion" : "v3", "metadata" : { "uid" : "24b23108-55c0-11e9-926f-0255ac101a31", "name" : "gpu-beta", "creationTimestamp" : "2019-04-03T03:25:34Z", "updateTimestamp" : "2019-04-03T03:25:34Z" }, "spec" : { "clusterID" : "0c0e4a63-5539-11e9-95f7-0255ac10177e", "version" : "1.0.0", "addonTemplateName" : "gpu-beta", "addonTemplateType" : "helm", "addonTemplateLogo" : "", "addonTemplateLabels" : [ "Accelerator" ], "description" : "A device plugin for nvidia.com/gpu resource on nvidia driver", "values" : { "basic" : { "rbac_enabled" : true, "swr_addr" : "100.125.6.246:20202", "swr_user" : "hwofficial" } } }, "status" : { "status" : "installing", "Reason" : "", "message" : "", "targetVersions" : null, "currentVersion" : { "version" : "1.0.0", "input" : { "basic" : { "swr_addr" : "100.125.6.246:20202", "swr_user" : "hwofficial" }, "parameters" : { } }, "stable" : true, "translate" : { "en_US" : { "addon" : { "changeLog" : "A device plugin for nvidia.com/gpu resource on nvidia driver", "description" : "A device plugin for nvidia.com/gpu resource on nvidia driver" } }, "zh_CN" : { "addon" : { "changeLog" : "支持容器里使用GPU显卡的设备管理插件,仅支持nvidia驱动", "description" : "支持容器里使用GPU显卡的设备管理插件,仅支持nvidia驱动" } } }, "supportVersions" : null, "creationTimestamp" : "2018-10-23T13:14:55Z", "updateTimestamp" : "2018-12-07T09:40:24Z" } } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。
