产品属性
更新时间: 2023-04-19

# 修改属性

# 基本信息

Path: /v1/products/:instanceId/:productKey/features/properties/:name

Method: PUT

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
name

Body

名称类型是否必须默认值备注其他信息
dataSchemaobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ enumTypestring非必须
├─ enumValuesobject []非必须
├─ namestring必须
├─ enumValuestring必须
├─ displayNamestring非必须
├─ elementTypeobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须
├─ maxItemsnumber非必须
├─ fieldsobject非必须
├─ field1object非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ requiredstring []非必须
├─非必须
displayNamestring非必须
descriptionstring非必须
writableboolean非必须
unitTypestring非必须
unitstring非必须

# 返回数据

名称类型是否必须默认值备注其他信息
namestring非必须
dataSchemaobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ enumTypestring非必须
├─ enumValuesobject []非必须
├─ namestring非必须
├─ enumValuestring非必须
├─ displayNamestring非必须
├─ elementTypeobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须
├─ maxItemsnumber非必须
├─ fieldsobject非必须
├─ field1object非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ requiredstring []非必须
├─非必须
displayNamestring非必须
descriptionstring非必须
writableboolean非必须
unitTypestring非必须
unitstring非必须
createTimestring非必须
updateTimestring非必须

# 删除属性

# 基本信息

Path: /v1/products/:instanceId/:productKey/features/properties/:name

Method: DELETE

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
name

# 返回数据

名称类型是否必须默认值备注其他信息

# 添加属性

# 基本信息

Path: /v1/products/:instanceId/:productKey/features/properties

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

Body

名称类型是否必须默认值备注其他信息
namestring必须^[a-zA-Z](?:[a-zA-Z0-9_]{0,48}[a-zA-Z0-9])?$
dataSchemaobject必须DataSchema类型,见备注
├─ @typestring必须[boolean, date, dateTime, timestamp, time, double, float, integer, long, string, array, enum, object ]
├─ formatstring非必须[date, dateTime, time]
├─ minnumber非必须[double, float, integer, long]
├─ maxnumber非必须[double, float, integer, long]
├─ stepnumber非必须[double, float, integer, long]
├─ patternstring非必须[string],最大100个字符
├─ minLengthinteger非必须[string],(0, MAX_INT32]
├─ maxLengthinteger非必须[string], (minLength, MAX_INT32]
├─ enumTypestring非必须[enum],optional: [integer, string]
├─ enumValuesobject []非必须[enum],最大20个enumValue
├─ namestring必须^[a-zA-Z](?:[a-zA-Z0-9_]{0,62}[a-zA-Z0-9])?$
├─ enumValuestring必须^[\w\W]{1,32}$
├─ displayNamestring非必须可以不填该参数,填写该参数时需符合^[\w\W]{1,64}$
├─ elementTypeobject非必须[array],DataSchema类型,见备注,不支持array、enum、object
├─ @typestring必须boolean、date、dateTime、timestamp、time、double、float、integer、long、string
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须最大200个字符
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须[array], (0, MAX_INT32]
├─ maxItemsnumber非必须[array], (minItems, MAX_INT32]
├─ fieldsobject非必须[object],可以有最大30个field,field名由用户指定,需符合^[a-zA-Z](?:[a-zA-Z0-9_]{0,62}[a-zA-Z0-9])?$
├─ field1object非必须DataSchema类型,见备注,不支持array、enum、object
├─ @typestring必须boolean、date、dateTime、timestamp、time、double、float、integer、long、string
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须最大200个字符
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ requiredstring []非必须[object]
├─非必须
displayNamestring必须"^[\\s\\S]{2,50}$"
descriptionstring非必须"^[\\s\\S]{0,200}$"
writableboolean非必须
unitTypestring非必须使用unit参数时,unitType为必需参数
unitstring非必须

# 返回数据

名称类型是否必须默认值备注其他信息
namestring非必须
dataSchemaobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ enumTypestring非必须
├─ enumValuesobject []非必须
├─ namestring非必须
├─ enumValuestring非必须
├─ displayNamestring非必须
├─ elementTypeobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须
├─ maxItemsnumber非必须
├─ fieldsobject非必须
├─ field1object非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ requiredstring []非必须
├─非必须
displayNamestring非必须
descriptionstring非必须
writableboolean非必须
unitTypestring非必须
unitstring非必须
createTimestring非必须
updateTimestring非必须

# 获取属性

# 基本信息

Path: /v1/products/:instanceId/:productKey/features/properties/:name

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
name

# 返回数据

名称类型是否必须默认值备注其他信息
namestring非必须

mock: @word

dataSchemaobject非必须
├─ @typestring非必须

枚举: enum,string,float,enum,array,object,timestamp,dateTime

├─ formatstring非必须

枚举: HH:mm:ss.SSS,yyyy-MM-dd,yyyy-MM-dd'T'HH:mm:ss.SSS

├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ enumTypestring非必须

枚举: string,integer

├─ enumValuesobject []非必须

item 类型: object

├─ namestring必须

mock: @word

├─ enumValuestring必须

mock: @word

├─ displayNamestring非必须

mock: @word

├─ elementTypeobject非必须
├─ @typestring非必须

枚举: string,float,timestamp,dateTime

├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须
├─ maxItemsnumber非必须
├─ fieldsobject非必须
├─ field1object非必须
├─ @typestring非必须

枚举: enum,string,float,timestamp,dateTime

├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ field2object必须
├─ @typestring必须
├─ requiredstring []非必须

item 类型: string

├─非必须
displayNamestring非必须

mock: @word

descriptionstring非必须

mock: @natural

writableboolean非必须
unitTypestring非必须
unitstring非必须
createTimestring非必须
updateTimestring非必须

# 获取属性列表

# 基本信息

Path: /v1/products/:instanceId/:productKey/features/properties

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

Query

参数名称 是否必须 示例 备注
pageNo
pageSize

# 返回数据

名称类型是否必须默认值备注其他信息
totalCountnumber非必须
resultobject []非必须

item 类型: object

├─ namestring非必须

mock: @word

├─ dataSchemaobject非必须
├─ @typestring非必须

枚举: enum,string,float,array,object,timestamp,dateTime

├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ enumTypestring非必须
├─ enumValuesobject []非必须

item 类型: object

├─ namestring非必须
├─ enumValuestring非必须
├─ displayNamestring非必须
├─ elementTypeobject非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ minItemsnumber非必须
├─ maxItemsnumber非必须
├─ fieldsobject非必须
├─ field1object非必须
├─ @typestring非必须
├─ formatstring非必须
├─ minnumber非必须
├─ maxnumber非必须
├─ stepnumber非必须
├─ patternstring非必须
├─ minLengthnumber非必须
├─ maxLengthnumber非必须
├─ requiredstring []非必须

item 类型: string

├─非必须
├─ displayNamestring非必须
├─ descriptionstring非必须
├─ writableboolean非必须
├─ unitTypestring非必须
├─ unitstring非必须
├─ createTimestring非必须
├─ updateTimestring非必须
pageNonumber非必须
pageSizenumber非必须