创建自定义元数据

产品：云主机 ECS 更新于 2026-08-10

接口说明

创建自定义元数据。元数据相关介绍可参考：查看实例元数据。

1.实例在active(运行中)状态才能做此操作。

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用，同时自动生成动态代码示例，搭配OpenAPI SDK无需计算签名实现接口快速集成。

POST https://ecloud.10086.cn/api/openapi-instance/v4/metadata/create

参数名称	类型	必填	描述
createMetadataReq	CreateMetadataReq	是	createMetadataReq
instanceId	string	是	实例ID，可通过查询实例状态列表接口获取。
metadataList	<MetadataItem> array	是	元数据列表。
key	string	是	元数据key值，可以为大写字母（A-Z）、小写字母（a-z）、数字（0-9）、中划线（-）、下划线（_）、冒号（:）和小数点（.），最大长度248个字符。
value	string	是	元数据value值，最大长度255个字符。

POST https://ecloud.10086.cn/api/openapi-instance/v4/metadata/create

{
	"instanceId":"c37945d7-0859-4c88-906b-0c49f79b64e0",
	"metadataList":[
		{
			"key":"abc",
			"value":"123"
		}
	]
}

返回码：200

参数名称	类型	描述
body	boolean	请求成功时返回的数据。
errorCode	string	统一错误码。
errorMessage	string	页面国际化错误提示。
errorParams	<string> array	统一错误码的自定义参数。
requestId	string	每个请求的序列号。
state	enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)	返回状态码。返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN。

返回码：200

{
	"requestId":"req-150f330d-2b38-4da8-9113-99992ded4601",
	"state":"OK",
	"body":true
}

本文档内容整理自移动云官方帮助中心（查看原文），仅供参考。