设备接入 IOTDA-创建预调配模板:响应参数

时间:2024-06-28 09:24:33

响应参数

状态码: 201

表10 响应Body参数

参数

参数类型

描述

template_id

String

参数说明:预调配模板ID。

template_name

String

参数说明:预调配模板名称。 取值范围:长度不超过128,只允许中文、字母、数字、下划线(_)、连接符(-)的组合。

description

String

参数说明:预调配模板的描述信息。 取值范围:长度不超过2048,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合

最大长度:2048

template_body

ProvisioningTemplateBody object

参数说明:预调配模板详细内容,json格式。

create_time

String

物联网平台 创建预调配模板的时间。格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。

update_time

String

在物联网平台更新预调配模板的时间。格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。

表11 ProvisioningTemplateBody

参数

参数类型

描述

parameters

Object

参数说明:预调配模板参数, ,配置格式为{"parameter":{"type":"String"}} ,其中parameter目前支持从预调配设备的证书的使用者字段提取内容,证书必须包含模板中定义的所有参数值,华为云IoT平台定义了可在预调配模板中声明和引用的如下参数:

  • iotda::certificate::country (国家/地区,C )

  • iotda::certificate::organization (组织,O)

  • iotda::certificate::organizational_unit (组织单位,OU)

  • iotda::certificate::distinguished_name_qualifier (可辨别名称限定符,dnQualifier)

  • iotda::certificate::state_name (省市,ST)

  • iotda::certificate::common_name (公用名,CN)

  • iotda::certificate::serial_number (序列号,serialNumber)

type描述parameter的类型,目前仅支持string。

配置样例:

'{"iotda::certificate::country":{"type":"String"},

"iotda::certificate::organization":{"type":"String"},

"iotda::certificate::organizational_unit":{"type":"String"},

"iotda::certificate::distinguished_name_qualifier":{"type":"String"},

"iotda::certificate::state_name":{"type":"String"},

"iotda::certificate::common_name":{"type":"String"},

"iotda::certificate::serial_number":{"type":"String"}}'

resources

TemplateResource object

预调配模板设备资源结构体。

表12 TemplateResource

参数

参数类型

描述

device

DeviceResource object

预调配模板设备资源详情结构体。

policy

PolicyResource object

预调配模板设备策略资源详情结构体。

表13 DeviceResource

参数

参数类型

描述

device_name

ParameterRef object

设备名称

node_id

ParameterRef object

设备标识码

product_id

Object

参数说明:设备所属的产品id,可以是一个明确的静态字符串id,也可以是动态的模板参数引用

  • 明确的静态字符串:"642bf260f2f9030e44210d8d"。取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。"

  • 参数引用: {"ref" : "iotda::certificate::country"}

tags

Array of TagRef objects

参数说明:设备绑定的标签列表

表14 ParameterRef

参数

参数类型

描述

ref

String

参数引用名称

表15 TagRef

参数

参数类型

描述

tag_key

Object

参数说明:标签键名称,可以是一个明确的静态字符串,也可以是动态的模板参数引用

  • 明确的静态字符串:"myTagKey"。取值范围:长度不超过64,只允许中文、字母、数字、以及_.-等字符的组合

  • 参数引用: {"ref" : "iotda::certificate::country"}

tag_value

Object

参数说明:标签值,可以是一个明确的静态字符串,也可以是动态的模板参数引用

  • 明确的静态字符串:"myTagValue"。取值范围:长度不超过128,只允许中文、字母、数字、以及_.-等字符的组合。

  • 参数引用: {"ref" : "iotda::certificate::country"}

表16 PolicyResource

参数

参数类型

描述

policy_ids

Array of strings

参数说明:设备需要绑定的策略id列表

support.huaweicloud.com/api-iothub/CreateProvisioningTemplate.html