MindSphere 服务 - 索引¶
本部分列出了所有当前已发布的可用服务。随着我们的产品生态系统不断丰富,本部分内容将定期进行更新。有关 MindSphere 中 API 版本控制和 API 生命周期的详细信息,请参见概念部分。
MindSphere APIS 基于 HTTP 或基于消息。基于 HTTP 的 API 通过 OpenAPI 规范描述客户端调用的服务所提供的 HTTP 操作。基于消息的 API通过 AsyncAPI 规范描述服务提供的主题和消息,客户端可以订阅或发布这些主题和消息。
下表列出了所有可用的 MindSphere 服务,并提供了相应区域的描述和可用的 API 版本。API 版本默认是基于 HTTP 的。如果提供了 AsyncAPI,则会对该版本添加相应说明。
警告
如果请求主体为空,请勿设置GET请求头部的ContentType
字段为application/json
。否则,许多防火墙会将其视为无效请求进行拦截。
说明
MindSphere 即将在新发布的版本中采用更严格的 API 请求 URL 验证,以使平台更加安全。。API 请求 URL 将根据指向专用资源的请求中尾部斜杠字符的使用进行验证。请参考下表中包含错误 URL 和正确 URL 的示例。这将应用于 MindSphere 中的所有 API。
我们要求开发人员检查他们的代码并相应地调整请求。在执行严格的 API 请求 URL 验证之前,我们将发布额外公告。
错误请求示例 | 正确请求示例 |
---|---|
GET https://gateway.{region}.{mindsphere-domain}/api/iottsaggregates/v3/aggregates/{assetId}/{aspectName}/ | GET https://gateway.{region}.{mindsphere-domain}/api/iottsaggregates/v3/aggregates/{assetId}/{aspectName} |
GET https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assets/{id}/?includeShared=true | GET https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assets/{id}?includeShared=true |
PUT https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assettypes/{id}/ | PUT https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assettypes/{id} |
Platform Core¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Identity Management | 使用 Customer Management API 仅管理自己租户的客户(如添加新客户或更改现有客户)。 | 3.3.0 | 3.1.2 | 3.3.0 |
OAuth Authorization Server | 使用 OAuth Authorization Server 请求身份验证和授权。 | 3.1.0 | 3.1.0 | 3.1.0 |
Tenant Management | 使用 Tenant Management 来管理:子租户、租户信息和法律信息。 | 4.4.1 | 4.3.0 | 4.5.0 |
Usage Transparency Service | 利用 Usage Transparency Service 提供的 UI,您可以通过 MindSphere 平台了解资源消耗情况。该服务还为开发者提供了一个 API,用于跟踪开发者定义的指标。此外,您还可以通过 UTS API 检索该指标。 | 3.2.0 | 3.2.0 | 3.2.0 |
IoT and Storage¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
IoT File | File Service 用于读取、写入和删除文件:上传、更新和删除与 assets 相关的文件,存储元数据信息,并按元数据搜索文件。 | 3.2.4 | 3.2.4 | 3.2.4 |
Integrated Data Lake | MindSphere 的 Integrated Data Lake 应用用于导入和存储历史 IoT 数据,访问交叉账户并对数据进行分析。 | 3.2.0 | - | - |
IoT Time Series | 使用 Time Series 创建、读取、更新和删除动态数据。由于时间序列数据始终与 asset 相关,因此您必须首先创建 asset 实例。 | 3.4.1 | 3.4.1 | 3.4.1 |
IoT TS Aggregates | 使用 Time Series Aggregates Service 读取聚合的时间序列值。按照时间间隔检索以下聚合值:计数、总和、平均值、最小值、最大值、第一个值,最后一个值和标准偏差。 | 3.3.1 4.0.0 | 3.3.1 4.0.0 | 3.3.1 4.0.0 |
IoT TS Bulk | 使用 Time Series Bulk Service 导入和读取高频时间序列数据。 | 3.5.2 | 3.5.2 | 3.5.2 |
Connectivity¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Agent Management | 使用 Agent Management 创建、编辑或删除 MindConnect elements、激活和取消激活代理以及设置与 assets 的关系。 | 3.4.0 | 3.2.0 | 3.3.0 |
MindConnect API | 使用 MindConnect API 开发自定义代理并将设备或应用连接到 MindSphere。 | 3.6.0 | 3.6.0 | 3.6.0 |
MindConnect OPC UA PubSub | 根据 OPC UA PubSub 规范使用 MindConnect OPC UA PubSub 向设备代理提供基于 MQTT 的 API 数据上传。 | 3.0.0 (Aysnc API) | - | - |
Advanced Services¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Asset Management | 在MindSphere中代表您的站点的物理 assets。使用模型并创建实例,设置与其它实例的关系以及创建层次结构等结构。 | 3.12.2 | 3.12.2-eu2-0.0 | 3.12.1 |
Event Management | 管理标准化和自定义的事件。从字段和其它应用获取事件。 | 3.8.2 | 3.8.2 | 3.8.1 |
Data Flow Engine | 提供工作流程编排。根据传入的数据创建自定义规则、即时应用规则并据此定义操作 | 3.1.0 | 3.1.0 | – |
Notification Service | 使用API或图形用户界面通过电子邮件、短信或推送/预定通知向您的用户和客户发送信息。 | 4.0.0 3.4.0 | 4.0.0 3.4.0 | 3.4.0-cn1-0.0 |
Analytics Services¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Anomaly Detection | Anomaly Detection Service 旨在使用时间序列数据自动检测过程和 assets 的异常行为。 | 3.4.0 | 3.4.0-eu2-0.0 | 3.3.0 |
Data Exchange | Data Exchange Service 通过简单的 REST API 调用提供远程文件存储和管理支持。该服务支持在相同的租户文件或文件夹中上传、下载、重命名和发布文件。 | 3.0.0 | 3.0.0 | 3.0.0 |
Event Analytics | Event Analytics Service 为事件数据的数据驱动分析提供基本功能。通过统计分析,用户可以更好地理解系统的内部运作。 | 3.1.1 | 3.1.1 | 3.1.1 |
Job Manager | 客户可以通过 Job Manager Service 采用调度机制执行 Zeppelin Notebooks,该服务还为运行模型所需的执行环境、清理、存储和库支持提供全面支持。 | 3.0.0 | – | 3.0.0 |
KPI Calculation | KPI Calculation Service 可计算 Asset 的关键绩效指标 (KPI)。它使用的数据源包括传感器、控制事件和日历条目等。 | 3.1.0 | 3.1.0 | 3.1.0 |
Model Management | Model Management Service 提供支持版本控制的分析模型管理文件存储。该服务可以协助维护版本、相关性、参数和创建者信息。 | 3.1.0 | 3.1.0 | 3.1.0 |
Signal Calculation | Signal Calculation Service 处理实体传感器的时间序列数据。该服务可聚合、修改、平滑和转换原始传感器数据,以便与原始数据一起进行进一步分析或存储。 | 3.1.0 | 3.1.0 | 3.1.0 |
Signal Validation | Signal Validation Service 审核实体的传感器时间序列数据。API 提供了一组用于信号审核的常用操作。 | 3.1.0 | 3.1.0 | 3.1.0 |
Spectrum Analysis | Spectrum Analysis Service 允许用户进行时域和频域分析。 | 3.0.0 | 3.0.0 | 3.0.0 |
Trend Prediction | Trend Prediction Service 能够使用线性和非线性回顾模型预测时间序列的未来值,它是一款在 Process & Condition Monitoring 领域具备众多实用应用的预测框架。 | 3.1.0 | 3.1.0 | 3.1.0 |
Exchange Services¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Token Manager | Token Manager API 可提供某个应用的访问权限,以访问使用该应用的其它租户的数据。 | 3.3.0 | 3.3.0 | 3.3.0 |
MindConnect Open Edge Services¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
Deployment Workflow | Deployment Workflow Service用来定义与设备的握手过程。 | 3.0.0 | 3.0.0 | 3.0.0 |
Device Configuration | Device Configuration Service为管理设备的配置文件和向设备发送配置任务提供接口。 | 3.0.1 | 3.0.1 | 3.0.1 |
Device Management | Device Management Service用来管理设备的类型和所有设备的数据库,以及实现从设备代理到设备的映射。 | 3.0.0 | 3.0.0 | 3.0.0 |
Device Status | Device Status Service为管理所有已安装的软件的数据库和设备的健康信息提供接口。 | 3.0.0 | 3.0.0 | 3.0.0 |
Edge App Deployment | Edge App Deployment Service为部署应用到设备提供接口。 | 3.0.0 | 3.0.0 | 3.0.0 |
Edge App Instance Management | App Instsance Management Service用来记录运行在设备上的Edge应用实例及其配置。 | 3.0.0 | 3.0.0 | 3.0.0 |
Firmware Deployment | Firmware Deployment Service为部署固件到设备提供接口。 | 3.0.0 | 3.0.0 | 3.0.0 |
Semantic Data Interconnect Services¶
服务 | 描述 | Europe 1 | Europe 2 | China 1 |
---|---|---|---|---|
SDI Data Management | SDI Data Management Service 用于为建立语义关联和数据查询处理准备数据。 | 4.2.0 | - | |
SDI Data Query | SDI Data Query Service 用于创建、更新、检索和删除查询。 | 4.2.0 | - | |
SDI Semantic Modelling | SDI Semantic Modelling Service 提供端到端能力来导入/创建,更新或删除整个本体/语义模型。 | 4.2.0 | - |
Last update: June 27, 2023