Asset Management Service – 基本 Asset Types
本部分列出了可用的基本 asset types。可通过租户 ID core
进行识别,例如在 core.basicdevice
中。
大多数基本 asset types 都提供以下常规属性:
属性 | 描述 |
---|---|
parentTypeId | 从中派生此 asset type 的 ID |
instantiable | 指示是否可以从此 type 创建实例。 Asset types,不能实例化的也称为抽象 types。 |
scope | 指示 asset type 是否可供所有租户(公共)使用或仅可供创建了该 asset type 的租户使用。 所有基本 asset types 都有公共范围。在租户中创建的 asset types 的范围自动设置为 private 。范围无法更改。 |
有关各属性值的限制,请参见 API 规范。
基本 Asset
基本 asset type 是 Asset Management Service 的基本/根 type。每种 asset type 都继承自此 type。基本 asset type 是抽象 types,因此无法从中创建 assets。
代码示例:
{
"parentTypeId":null,
"instantiable":false,
"tenantId": "core",
"name":"BasicAsset",
"description":"Base type for the Asset Management Service.",
"scope": "public",
"variables": [
{
"name": "externalId",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"aspects": [],
"fileAssignments": [],
"etag":1,
"_links": {
"self": {
"href": "{link}"
}
},
"id": "core.basicasset"
}
基本层级
基本层级 types 是所有层级 types 的模板。它们用于对固定的物理 assets(如房屋、工厂或设备)进行建模,以便以层级的形式构建 assets 并降低复杂性。基本层级 type 是抽象 type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicasset",
"instantiable":false,
"tenantId": "core",
"name":"BasicHierarchy",
"description":"Base hierarchy type for the Asset Management Service.",
"scope": "public",
"variables": [
{
"name": "hierarchyModel",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"aspects": [
{
"name": "contactPoint",
"aspectType": {
"id": "core.contactpoint",
"tenantId": "core",
"name":"ContactPoint",
"category": "static",
"scope": "public",
"description":"Contact point definition for basic asset hierarchy type.",
"variables": [
{
"name": "telephoneNumber",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "faxNumber",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "email",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "contactType",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basichierarchy"
}
根层级
根层级 type 是根 types 的模板。它们被用作租户或子租户结构的层级模型起点。创建租户或子租户时,必须创建根 asset。所有根 types 必须均继承根层级 type 。根层级 type 是抽象 type,因此无法从中创建 assets。
用户无法通过 Asset Management REST 调用创建根层级 type 派生的 assets。
代码示例:
{
"parentTypeId": "core.basichierarchy",
"instantiable":false,
"tenantId": "core",
"name":"RootHierarchy",
"description":"Root type for asset hierarchy.",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.roothierarchy"
}
Basic Enterprise
这是一个模板,必须通过该模板创建租户根 asset。
代码示例:
{
"parentTypeId": "core.roothierarchy",
"instantiable":true,
"tenantId": "core",
"name":"BasicEnterprise",
"description":"Basic Enterprise type for the Asset Management Service",
"scope": "public",
"variables": [
{
"name": "sameAs",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "legalName",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "organizationType",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "url",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicenterprise"
}
Basic Subtenant
这是一个模板,必须通过该模板在现有租户中创建子租户的根 asset。
代码示例:
{
"parentTypeId": "core.roothierarchy",
"instantiable":true,
"tenantId": "core",
"name":"BasicSubtenant",
"description":"SubTenant type for the Asset Management Service",
"scope": "public",
"variables": [
{
"name": "displayName",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicsubtenant"
}
基本站点
基本站点 type 用作工厂、办公室等站点的模板。Assets 部分建模说明了如何使用基本站点 type。
代码示例:
{
"parentTypeId": "core.basichierarchy",
"instantiable":true,
"tenantId": "core",
"name":"BasicSite",
"description":"Site type for creating asset hierarchy levels.",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicsite"
}
基本区域
基本区域用作站点内部区域的模板,如啤酒厂内的装瓶区或办公楼内的楼层。
代码示例:
{
"parentTypeId": "core.basichierarchy",
"instantiable":true,
"tenantId": "core",
"name":"BasicArea",
"description":"Area type for creating asset hierarchy levels.",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
}
"id": "core.basicarea"
}
基本代理
基本代理 type 是不同硬件盒子或代理 types 的模板。基本代理 type 是抽象 type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicasset",
"instantiable":false,
"tenantId": "core",
"name":"BasicAgent",
"description":"Basic agent type for the Asset Management Service.",
"scope": "public",
"variables": [],
"aspects": [
{
"name": "status",
"aspectType": {
"id": "core.agentstatus",
"tenantId": "core",
"name":"AgentOnlineStatus",
"category": "dynamic",
"scope": "public",
"description":"Online status of an agent typed asset.",
"variables": [
{
"name": "onlineStatus",
"unit":null,
"searchable":false,
"qualityCode":false,
"defaultValue":null,
"dataType":"BOOLEAN",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
}
"id": "core.basicagent"
}
MindConnect Nano
此 asset type 是 MindConnect Nano 连接元素的模板。
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"MindConnectNano",
"description":"MindConnect Nano Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.mcnano"
}
MindConnect Lib
此 asset type 是 MindConnect Library 连接元素的模板。
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"MindConnectLib",
"description":"MindConnect Lib Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.mclib"
}
MindConnect IoT 2040
此 asset type 是 MindConnect IoT 2040 连接元素的模板。
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"MindConnectIoT2040",
"description":"MindConnect IoT 2040 Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.mciot2040"
}
MindConnect FB1500
说明
此基本 type 已弃用。如果要在 MindSphere 上连接并代表 S7-1500,请使用 MindConnect Library。
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"MindConnectFB1500",
"description":"MindConnect FB 1500 Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.mcfb1500"
}
MindConnect Integration
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"MindConnectIntegration",
"description":"MindConnect Integration Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.mcintegration"
}
Industrial Edge
代码示例:
{
"parentTypeId": "core.basicagent",
"instantiable":true,
"tenantId": "core",
"name":"IndustrialEdge",
"description":"Industrial Edge Agent asset type",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.industrialEdge"
}
基本设备
基本设备 type 是机器或可从中收集数据的其它 assets 的模板。每种设备 asset type 都继承自基本设备 type。基本设备 type 是抽象 asset type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicasset",
"instantiable":false,
"tenantId": "core",
"name":"BasicDevice",
"description":"Basic device asset type for the Asset Management Service.",
"scope": "public",
"variables": [
{
"name": "manufacturer",
"unit":null,
"searchable":true,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"aspects": [
{
"name": "status",
"aspectType": {
"id": "core.assetstatus",
"tenantId": "core",
"name":"DeviceAssetStatus",
"category": "static",
"scope": "public",
"description":"Status of a device typed asset.",
"variables": [
{
"name": "connection_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
},
{
"name": "connection",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_unconfirmed",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
},
{
"name": "health",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_unconfirmed_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicdevice"
}
基本 Sinumerik Asset
基本 Sinumeric asset type 是 Sinumerik 设备的模板。基本 Sinumerik asset type 是抽象 asset type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicdevice",
"instantiable":false,
"tenantId": "core",
"name":"BasicSinumerikAsset",
"description":"Basic asset type for Sinumerik devices.",
"scope": "public",
"variables": [],
"aspects": [
{
"name":"CH1_BasicConfig",
"aspectType": {
"id": "core.sinumerikbasicconfig",
"tenantId": "core",
"name":"SinumerikBasicConfig",
"category": "dynamic",
"scope": "public",
"description":"CH1_BasicConfig for Sinumerik typed asset.",
"variables": [
{
"name":"NCProgramStatus",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"Spindleoverride",
"unit": "%",
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"StopCond",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"ProtectionLevel",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"NCProgram",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name":"Opmode",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"NrOfAlarms",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
},
{
"name":"Feedoverride",
"unit": "%",
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
},
{
"name":"Alarms",
"aspectType": {
"id": "core.sinumerikbasicalarms",
"tenantId": "core",
"name":"SinumerikBasicAlarms",
"category": "dynamic",
"scope": "public",
"description":"Alarms for Sinumerik typed asset.",
"variables": [
{
"name":"CurrentAlarms",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"BIG_STRING",
"length":100000
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
},
{
"name":"MachineModel",
"aspectType": {
"id": "core.sinumerikbasicmachinemodel",
"tenantId": "core",
"name":"SinumerikBasicMachineModel",
"category": "dynamic",
"scope": "public",
"description":"Machinemodel for Sinumerik typed asset.",
"variables": [
{
"name":"Data",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"BIG_STRING",
"length":100000
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
},
{
"name":"CH1_MachineStatus",
"aspectType": {
"id": "core.sinumerikbasicmachinestatus",
"tenantId": "core",
"name":"SinumerikBasicMachineStatus",
"category": "dynamic",
"scope": "public",
"description":"CH1_MachineStatus for Sinumerik typed asset.",
"variables": [
{
"name":"MachineStatus",
"unit": "%",
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"DOUBLE",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
},
{
"name":"Startup",
"aspectType": {
"id": "core.sinumerikbasicstartup",
"tenantId": "core",
"name":"SinumerikBasicStartup",
"category": "dynamic",
"scope": "public",
"description":"Startup for Sinumerik typed asset.",
"variables": [
{
"name": "shutdownTime",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
},
{
"name": "bootTime",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"STRING",
"length":255
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
},
{
"name":"AgentOnlineStatus",
"aspectType": {
"id": "core.agentstatus",
"tenantId": "core",
"name":"AgentOnlineStatus",
"category": "dynamic",
"scope": "public",
"description":"Online status of an agent typed asset.",
"variables": [
{
"name": "onlineStatus",
"unit":null,
"searchable":false,
"qualityCode":false,
"defaultValue":null,
"dataType":"BOOLEAN",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicsinumerikasset"
}
基本应用
基本应用 type 是应用的模板,可将数据提取至 MindSphere。基本应用 type 是抽象 asset type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicasset",
"instantiable":false,
"tenantId": "core",
"name":"BasicApplication",
"description":"Basic asset type for Applications",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.basicapplication"
}
Edge 基本应用
此 asset type 是所有 Edge 应用的模板。Edge 基本应用 type 是抽象 asset type,因此无法从中创建 assets。
代码示例:
{
"parentTypeId": "core.basicapplication",
"instantiable":false,
"tenantId": "core",
"name":"EdgeBasicApplication",
"description":"Represents the root asset type for all edge applications",
"scope": "public",
"variables": [],
"aspects": [
{
"name": "status",
"aspectType": {
"id": "core.assetstatus",
"tenantId": "core",
"name":"DeviceAssetStatus",
"category": "static",
"scope": "public",
"description":"Status of a device typed asset.",
"variables": [
{
"name": "connection_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
},
{
"name": "connection",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_unconfirmed",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
},
{
"name": "health",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name": "health_unconfirmed_timestamp",
"unit":null,
"searchable":true,
"qualityCode":false,
"defaultValue":null,
"dataType":"TIMESTAMP",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.edgebasicapplication"
}
Edge Analytics 应用
此 asset type 是 Edge 设备上存在的 Edge Analytics 应用的模板。
代码示例:
{
"parentTypeId": "core.edgebasicapplication",
"instantiable":true,
"tenantId": "core",
"name":"EdgeAnalyticsApplication",
"description":"Represents the Edge Analytics Application present on the Edge device",
"scope": "public",
"variables": [],
"aspects": [
{
"name":"EdgeAnalyticsApplicationStatus",
"aspectType": {
"id": "core.edgeanalyticsapplicationstatus",
"tenantId": "core",
"name":"EdgeAnalyticsApplicationStatus",
"category": "dynamic",
"scope": "public",
"description":"Status of the Edge Analytics Application",
"variables": [
{
"name":"CPU_usage",
"unit": "%",
"searchable":false,
"qualityCode":false,
"defaultValue":null,
"dataType":"INT",
"length":null
},
{
"name":"Project_state",
"unit":null,
"searchable":false,
"qualityCode":false,
"defaultValue":null,
"dataType":"BOOLEAN",
"length":null
},
{
"name":"Server_state",
"unit":null,
"searchable":false,
"qualityCode":false,
"defaultValue":null,
"dataType":"BOOLEAN",
"length":null
}
],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
}
}
}
}
],
"fileAssignments": [],
"etag": {etagValue},
"_links": {
"self": {
"href": "{link}"
},
"parent": {
"href": "{link}"
}
},
"id": "core.edgeanalyticsapplication"
}
Open Edge 设备
此 asset type 是用于 Open Edge 设备的模板。
代码示例:
{
"parentTypeId": "core.basicasset",
"instantiable": false,
"tenantId": "core",
"name": "EdgeDevice",
"description": "Open Edge device asset type for Asset Management Service.",
"scope": "public",
"variables": [],
"aspects": [],
"fileAssignments": [],
"sharing": {
"modes": []
},
"etag": 0,
"_links": {
"self": {
"href": "https://gateway.eu1-int.mindsphere.io/api/assetmanagement/v3/assettypes/core.edgedevice"
},
"parent": {
"href": "https://gateway.eu1-int.mindsphere.io/api/assetmanagement/v3/assettypes/core.basicasset"
}
},
"id": "core.edgedevice"
}
还有问题?
除非另行声明,该网站内容遵循MindSphere开发许可协议.