Navigation:  功能明细 > 数据转储 > 数据上云

1.概述

配置更新：

上云配置更新服务通过ICE提供上云配置更新的相关接口，BB调用该接口将配置json传输到上云配置更新服务，对上云配置进行更新。

状态查询：

上云配置更新服务通过ICE提供状态查询的相关接口，BB调用该接口将查询ihd配置状态。

BB接口：详见子目录“Tag点上云接口”

 

配置文件说明：

ihd.connection用于配置ihd连接。

HDConfigHandler.Endpoints用于配置服务对外端口，一般只需修改tcp端口即可。

 

# The server creates one single object adapter with the name

# "HDConfigHandler". The following line sets the endpoints for this

# adapter.

#

IdentityName=HDConfigHandler

ihd.connection=admin:admin@10.25.190.34:5673

HDConfigHandler.Endpoints=tcp -p 30000:udp -p 30000:ws -p 10002

#

# Warn about connection exceptions

#

Ice.Warn.Connections=0

Ice.ThreadPool.Server.Size=5

 

接口说明：

module ihd

{

   exception InvokeError

   {

       string reason;

   }

 

   sequence<byte> JsonSeq;

 

   interface HDConfigHandler

   {

       int updateConfig(JsonSeq request, out JsonSeq response) throws InvokeError;

       int deleteConfig(JsonSeq request, out JsonSeq response) throws InvokeError;

       int queryState(JsonSeq request, out JsonSeq response) throws InvokeError;

       int queryServiceState(out JsonSeq response) throws InvokeError;

   }

}

使用EiInfo类组织上云配置二进制数据，在调用ConfigUpdate接口前：

调用SerializeEIClassToJSonV2接口将EiInfo转换为json字符串，该json字符串二进制数据作为ConfigUpdate接口的传入参数。

调用EiInfo类提供的Serialize接口将EiInfo对象序列化，作为传入参数传入ConfigUpdate。

成功返回0，失败返回错误码。

 

上云配置新增 / 更新：

 

 

上云配置删除：

 

配置状态查询：

 

上云服务状态查询：

 

json示例：

配置更新：

输入示例：

{

    "type": 0,

    "sumNum": 2,

    "tags": [

        {

            "UNIT_NUMBER": "0",

            "TAG_NAME": "TagName0",

            "TAG_CLOUD_EN_NAME": "tag0",

            "TAG_CLOUD_CH_NAME": "标签0",

            "TAG_REFERENCE_EN_NAME": "tag0",

            "TAG_REFERENCE_CH_NAME": "refTag0",

            "TAG_REFERENCE_SOURCE_IDENTIFIER": "",

            "FACTORY": "factory",

            "AREA": "area",

            "TAG_EQUIPMENT": "Tag",

            "TAG_SYNC_TYPE": 0,

            "TAG_COLLECT_INTERVAL": 1,

            "TAG_PERIOD": 1,

            "TAG_SEND_FREQUENCY": 1,

            "TAG_SEND_MODE": "D",

            "TAG_COMPDEV": 0,

            "TAG_INTEGER_NUMBER": 0,

            "TAG_EFFECTIVE_NUMBER": 0,

            "TAG_COEFFICIENT": 0

        },

        {

            "UNIT_NUMBER": "1",

            "TAG_NAME": "TagName1",

            "TAG_CLOUD_EN_NAME": "tag1",

            "TAG_CLOUD_CH_NAME": "标签1",

            "TAG_REFERENCE_EN_NAME": "tag1",

            "TAG_REFERENCE_CH_NAME": "refTag1",

            "TAG_REFERENCE_SOURCE_IDENTIFIER": "",

            "FACTORY": "factory",

            "AREA": "area",

            "TAG_EQUIPMENT": "Tag",

            "TAG_SYNC_TYPE": 0,

            "TAG_COLLECT_INTERVAL": 1,

            "TAG_PERIOD": 1,

            "TAG_SEND_FREQUENCY": 1,

            "TAG_SEND_MODE": "D",

            "TAG_COMPDEV": 0,

            "TAG_INTEGER_NUMBER": 0,

            "TAG_EFFECTIVE_NUMBER": 0,

            "TAG_COEFFICIENT": 0

        }

    ]

}

 

输出示例：

{

    "updatedTags": 2,

    "invalidTags": 2,

    "reasons": [

        {

            "tagName": "TagName0",

            "reason": "Invalid json field: TAG_SEND_MODE"

        },

        {

            "tagName": "TagName1",

            "reason": "Invalid json field: TAG_SEND_MODE"

        }

    ]

}

 

配置删除：

输入示例：

{

    "tags": [

        {

            "tagName": "TagName0"

        },

        {

            "tagName": "TagName1"

        }

    ]

}

 

输出示例：

{

    "deletedTags": 2,

    "invalidTags": 2,

    "reasons": [

        {

            "tagName": "TagName0",

            "reason": "No such tag."

        },

        {

            "tagName": "TagName1",

            "reason": "No such tag."

        }

    ]

}

 

状态查询：

输入示例：

{

    "startTime": "2023-07-05T09:00:00",

    "sendMode": "D"

}

 

输出示例：

{

    "syncedTags": 3,

    "configedTags":10，

    "bugTags": [

        {

            "tagName": "TagName0",

            "cloudEnName": "TagName0"，

            "lastSyncTime": "1689736706000"，

        },

        {

            "tagName": "TagName1",

            "cloudEnName": "TagName1"，

            "lastSyncTime": "1689736706000"，

        }

    ]

}

 

上云服务状态查询：

输出示例：

{

    "result": 2,

    "startTime":"2023-07-13T09:00:00",

    "stoptime":"2023-07-13T09:00:00"，

    "reason": "Disk full."

}