Wind River Intelligent Device Platform XT EMS Profile WIND RIVER EMS DEVICE MANAGEMENT USER'S GUIDE 1.0
Copyright Notice Copyright 2014 Wind River Systems, Inc. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means without the prior written permission of Wind River Systems, Inc. Wind River, Tornado, and VxWorks are registered trademarks of Wind River Systems, Inc. The Wind River logo is a trademark of Wind River Systems, Inc. Any third-party trademarks referenced are the property of their respective owners. For further information regarding Wind River trademarks, please see: www.windriver.com/company/terms/trademark.html This product may include software licensed to Wind River by third parties. Relevant notices (if any) are provided in your product installation at one of the following locations: installdir/product_name/3rd_party_licensor_notice.pdf installdir/legal-notices/ Wind River may refer to third-party documentation by listing publications or providing links to third-party Web sites for informational purposes. Wind River accepts no responsibility for the information provided in such third-party documentation. Corporate Headquarters Wind River 500 Wind River Way Alameda, CA 94501-1153 U.S.A. Toll free (U.S.A.): 800-545-WIND Telephone: 510-748-4100 Facsimile: 510-749-2010 For additional contact information, see the Wind River Web site: www.windriver.com For information on how to contact Customer Support, see: www.windriver.com/support 09 Dec 2014
Contents 1 EMS Device Management Overview... 5 About EMS Device Management... 5 2 Mashery API Reference... 7 About Mashery APIs... 8 Alarm Object APIs... 9 Alarm Examples... 10 Asset Object APIs... 12 Asset Examples... 14 Asset Configuration Object APIs... 14 Asset Group Object APIs... 16 Asset Group Examples... 17 Audit Object APIs... 19 Custom Object APIs... 20 Custom Object Examples... 21 Custom Object Group Object APIs... 22 Data Item Object APIs... 24 Data Item Examples... 26 Deployment Object APIs... 27 Expression Rule Object APIs... 28 Expression Rule Examples... 30 Extended Application Object APIs... 31 Extended List Object APIs... 33 Extended Map Object APIs... 34 Extended UI Module Object APIs... 36 External Credential Object APIs... 37 File Info Object APIs... 39 File Upload Session Object APIs... 40 Location Object APIs... 41 Machine Stream Object APIs... 42 Model Object APIs... 44 Organization Object APIs... 45 Region Object APIs... 46 Remote Server Object APIs... 48 Remote Session Object APIs... 48 iii
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Self Service Object APIs... 50 Software Package Object APIs... 51 Transport Configuration Object APIs... 52 Unit Of Measure Object APIs... 53 User Object APIs... 55 User Group Object APIs... 56 User Privilege Object APIs... 58 User Settings APIs... 59 Web Resource Object APIs... 60 iv
1 EMS Device Management Overview About EMS Device Management 5 About EMS Device Management The Wind River Edge Management System enables you to remotely manage devices running the EMS agent. The EMS Server is the cloud side of the Edge Management System. It receives data from the EMS agent on the devices connected to the server. When a device connects to the EMS server, it appears as an asset. The EMS Console provides an administrative interface to the server. You can also create your own application using the Mashery APIs to customize the administration and management of assets, and to export data to back end systems for further processing. The EMS Server stores data only for the previous 90 days. To maintain data history, you should export the data at regular intervals. 5
2 Mashery API Reference About Mashery APIs 8 Alarm Object APIs 9 Asset Object APIs 12 Asset Configuration Object APIs 14 Asset Group Object APIs 16 Audit Object APIs 19 Custom Object APIs 20 Custom Object Group Object APIs 22 Data Item Object APIs 24 Deployment Object APIs 27 Expression Rule Object APIs 28 Extended Application Object APIs 31 Extended List Object APIs 33 Extended Map Object APIs 34 Extended UI Module Object APIs 36 External Credential Object APIs 37 File Info Object APIs 39 File Upload Session Object APIs 40 Location Object APIs 41 Machine Stream Object APIs 42 Model Object APIs 44 Organization Object APIs 45 Region Object APIs 46 7
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Remote Server Object APIs 48 Remote Session Object APIs 48 Self Service Object APIs 50 Software Package Object APIs 51 Transport Configuration Object APIs 52 Unit Of Measure Object APIs 53 User Object APIs 55 User Group Object APIs 56 User Privilege Object APIs 58 User Settings APIs 59 Web Resource Object APIs 60 About Mashery APIs Mashery APIs enable you to write custom applications using REST API calls over HTTP to manage devices that run the EMS agent. The Mashery APIs are grouped into objects, each with a set of methods. The objects are based on those provided by the Axeda Platform Web Services, v2. The APIs enable you to programmatically perform many of the functions that are available from the EMS Console. Mashery APIs are available only to manage assets that run the EMS agent. Each Mashery API call requires a Mashery API key that controls the endpoints the application can access. You receive the key when you receive your Mashery account. Each user application must provide a unique API key in the HTTP query string for each REST API call. To use the APIs in your programming environment, retrieve the WADL definitions from the following URL: https://servername/services/v2/rest?_wadl You can use the REST API calls directly in JSON or XML format, or you can convert the file into Java classes to use in a Java programming environment. For more information, see the following documents: Axeda Agent Web Services Guide, 6.8.0 Axeda v2 API/Services Developer's Reference, 6.8 To test the API services using I/O Docs, log in to the following website with your Mashery username and password: http://windriver.mashery.com On the Home page, click See APIs in Action with I/O Docs. 8
2 Mashery API Reference Alarm Object APIs Alarm Object APIs Alarm object APIs enable you to create, read, and update alarms on an asset or group of assets. Alarms typically indicate an error condition in the software or hardware on an asset, such as the failure of a hardware component. The Mashery APIs enable you to specify the conditions that trigger an alarm, retrieve information about alarms on the system, and manage the alarm status. For more information about alarms and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Alarms Axeda Platform Axeda v2 API/Services Developer s Reference: AlarmBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: AlarmBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/alarmbridge.html Counts the number of alarms based on criteria. Creates an alarm based on the alarm property values. Returns the state changes of an alarm. Finds an alarm based on the system identifier or alternate identifier. Finds alarms that match the specified search criteria. Finds alarms based on alarm identifiers in the request body. Returns a list of historical alarm values. rest/alarm/count rest/alarm rest/alarm/id/systemid/alarmstatechanges rest/alarm/id/identifier rest/alarm/find rest/alarm/findbyids rest/alarm/findinhistory 9
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Finds the first alarm that matches the specified criteria. Creates or updates an alarm. Sets the alarm state. properties of an existing alarm. Create one or more alarms. Creates or updates one or more alarms. properties of one or more alarms. rest/alarm/findone rest/alarm rest/alarm/setalarmstate?state=newalarmstate rest/alarm/id/systemid rest/alarm/bulk/create rest/alarm/bulk/save rest/alarm/bulk/update Related Links Alarm Examples on page 10 Alarm examples demonstrate selected methods in XML format. Alarm Examples Alarm examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. create This example shows a request to create an alarm on an asset. The request body identifies the asset by the model and serial number id="default_testmodel default_testasset". $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X PUT \ "https://windriver.api.mashery.com/servername/services/v1/rest/alarm? api_key=keyvalue" \ -d@alarm-create.xml \ tidy --show-warnings no -xml -i -q 10
2 Mashery API Reference Alarm Object APIs alarm-create.xml <?xml version="1.0" encoding="utf-8"?> <Alarm xmlns="http://www.axeda.com/services/v2"> <name>testalarm_delete_me</name> <asset id="default_testmodel default_testasset"/> <severity>100</severity> </Alarm> findinhistory This example shows a request using the Linux curl command to find the historical value of all the alarms on the system, based on the wildcard in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/alarm/findinhistory? api_key=keyvalue" \ -d@alarm-findinhistory.xml \ tidy --show-warnings no -xml -i -q alarm-findinhistory.xml <?xml version="1.0" encoding="utf-8"?> <HistoricalAlarmCriteria xmlns="http://www.axeda.com/services/v2"> <name>*</name> </HistoricalAlarmCriteria> findone This example shows the request to find an alarm using the critiera asset model and serial number specified in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/alarm/findone? api_key=keyvalue" \ -d@alarm-findone.xml \ tidy --show-warnings no -xml -i -q alarm-findone.xml <?xml version="1.0" encoding="utf-8"?> <AlarmCriteria xmlns="http://www.axeda.com/services/v2" > <asset id="default_testmodel default_testasset"/> </AlarmCriteria> setalarmstate This example shows a request to set the state of the specified alarm to ACKNOWLEDGED. The request body specifies the alarm by model number, serial number, and alarm name using the id="default_testmodel default_testasset testalarm_delete_me". $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/alarm/setalarmstate? 11
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 state=acknowledged&?api_key=keyvalue" \ -d@alarm-setalarmstate.xml \ tidy --show-warnings no -xml -i -q alarm-setalarmstate.xml <?xml version="1.0" encoding="utf-8"?> <AlarmCollection xmlns="http://www.axeda.com/services/v2"> <alarm xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:type="alarm" id="default_testmodel default_testasset testalarm_delete_me"> </alarm> </AlarmCollection> Related Links Alarm Object APIs on page 9 Alarm object APIs enable you to create, read, and update alarms on an asset or group of assets. Asset Object APIs Asset object APIs enable you to create, read, update, and delete one or more assets. An asset is a piece of equipment that can be monitored and managed using either the Mashery APIs or the EMS console. When a device running the EMS agent starts, it automatically connects to the EMS server and an asset representing the device appears on the EMS Console. You can also create an asset using the Mashery APIs. For more information about assets and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference:Assets Axeda Platform Axeda v2 API/Services Developer s Reference:AssetBridge:Methods Axeda Platform Axeda v2 API/Services Developer s Reference:AssetBridge:REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/assetbridge.html Counts the number of assets based on criteria. Creates an asset based on the asset property values. Deletes an asset. Finds an asset based on system identifier or alternate identifier. rest/asset/countassetsbycriteria rest/asset DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/asset/systemid rest/asset/id/identifier 12
2 Mashery API Reference Asset Object APIs Finds assets that match the specified search criteria. Finds assets based on asset identifiers in the request body. Returns the asset configuration. Finds the first asset that matches the specified criteria. Creates or updates an asset. Marks the specified asset as recently viewed. Returns a list of recently viewed assets. properties of an existing asset. Creates one or more assets. Deletes one or more assets. Creates or updates one or more assets. properties of one or more assets. rest/asset/find rest/asset/findbyids rest/asset/id/systemid/config rest/asset/findone rest/asset rest/asset/recentlyviewed/id/systemid rest/asset/recentlyviewed rest/asset/id/systemid rest/asset/bulk/create rest/asset/bulk/delete rest/asset/bulk/save rest/asset/bulk/update Related Links Asset Examples on page 14 13
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Alarm examples demonstrate selected methods in XML format. Asset Examples Alarm examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. Find (by criteria) This example shows a request to find assets using a wild card for the serial number (the criteria) in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/asset/find? api_key=apikey" \ -d@asset-findbycriteria.xml \ tidy --show-warnings no -xml -i -q asset-findbycriteria.xml <?xml version="1.0" encoding="utf-8"?> <AssetCriteria xmlns="http://www.axeda.com/services/v2"> <serialnumber>default*</serialnumber> </AssetCriteria> Related Links Asset Object APIs on page 12 Asset object APIs enable you to create, read, update, and delete one or more assets. Asset Configuration Object APIs Asset Configuration APIs enable you to create, read, update, and delete asset configurations. Asset configuration APIs enable you to create and update asset configuration information for one or more asset configurations, such as organization information. For more information about asset configuration configuration and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Asset Configuration Axeda Platform Axeda v2 API/Services Developer s Reference: AssetConfiguration: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: AssetConfiguration: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/ bridgeassetconfigurationbridge.html 14
2 Mashery API Reference Asset Configuration Object APIs Creates an asset configuration based on the asset configuration property values. Deletes an asset configuration. Finds an asset configuration based on an identifier. Finds asset configurations that match the specified search criteria. Finds asset configurations based on asset configuration identifiers in the request body. Returns the asset configuration. Finds the first asset configuration that matches the specified criteria. Creates or updates an asset configuration. properties of an existing asset configuration. Creates one or more asset configurations. Deletes one or more asset configurations. Creates or updates one or more asset configurations. rest/assetconfiguration DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/assetconfiguration/systemid rest/assetconfiguration/identifier rest/assetconfiguration/find rest/assetconfiguration/findbyids rest/assetconfiguration/id/systemid/config rest/assetconfiguration/findone rest/assetconfiguration rest/assetconfiguration/id/systemid rest/assetconfiguration/bulk/create rest/assetconfiguration/bulk/delete rest/assetconfiguration/bulk/save 15
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 properties of one or more asset configurations. rest/assetconfiguration/bulk/update Asset Group Object APIs Asset Group APIs enable you to create, read, delete, and update asset groups. An asset group contains one or more associated assets. Asset groups can also contain one other asset group. Assets can belong to multiple asset groups. For more information about asset groups and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: AssetGroupBridge Axeda Platform Axeda v2 API/Services Developer s Reference: AssetGroupBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: AssetGroupBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/assetgroupbridge.html Adds an asset to a group. Creates an asset group based on the asset group property values. Deletes an asset group. Finds an asset group based on an identifier. Finds asset groups that match the specified search criteria. Finds asset groups based on asset group identifiers in the request body. rest/assetgroup/id/systemid/assets rest/assetgroup DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/assetgroup/systemid rest/assetgroup/identifier rest/assetgroup/find rest/assetgroup/findbyids 16
2 Mashery API Reference Asset Group Examples Finds the first asset group that matches the specified criteria. Creates or updates an asset group. Returns the child asset groups of the specified asset group. Removes an asset from an asset group. properties of an existing asset group. Creates one or more asset groups. Deletes one or more asset groups. Creates or updates one or more asset groups. properties of one or more asset groups. rest/assetgroup/findone rest/assetgroup rest/assetgroup/children?id=systemid DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/assetgroup/id/assetgroupsystemid/assets/id/assetsystemid rest/assetgroup/id/systemid rest/assetgroup/bulk/create rest/assetgroup/bulk/delete rest/assetgroup/bulk/save rest/assetgroup/bulk/update Related Links Asset Group Examples on page 17 Asset Group examples demonstrate selected methods in XML format. Asset Group Examples Asset Group examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. addtogroup This example shows a request to add the asset with the model name default_testmodel and serial number default_testasset to an asset group that is specified by its system identifier. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ 17
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 -i -H "Accept: application/xml" \ -X PUT \ "https://windriver.api.mashery.com/servername/services/v1/rest/assetgroup/id/746/ assets?api_key=apikey" \ -d@assetgroup-addtogroup.xml \ tidy --show-warnings no -xml -i -q assetgroup-addtogroup.xml <Asset id="default_testmodel default_testasset" xmlns="http://www.axeda.com/services/ v2"> </Asset> create This example shows a request to create an asset group with the testassetgroup name. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X PUT \ "https://windriver.api.mashery.com/servername/services/v1/rest/assetgroup? api_key=apikey" \ -d@assetgroup-create.xml > tmp cat tmp tidy --show-warnings no -xml -i -q cat tmp grep -m 1 -o "<v2:id>.*</v2:id>" assetgroup-create.xml v2:assetgroup xmlns:v2="http://www.axeda.com/services/v2"> <v2:name>testassetgroup</v2:name> </v2:assetgroup> find (by criteria) This example shows a request to find asset groups using a wildcard for the serial number (the criteria) in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/assetgroup/find? api_key=apikey" \ -d@assetgroup-findbycriteria.xml \ tidy --show-warnings no -xml -i -q assetgroup-findbycriteria.xml <?xml version="1.0" encoding="utf-8"?> <AssetGroupCriteria xmlns="http://www.axeda.com/services/v2"> <serialnumber>default*</serialnumber> </AssetGroupCriteria> Related Links Asset Group Object APIs on page 16 18
2 Mashery API Reference Audit Object APIs Asset Group APIs enable you to create, read, delete, and update asset groups. Audit Object APIs The Audit APIs enable you to create and read entries in the EMS Server audit log. The audit log contains information about events that occur on the EMS Server. Audit APIs enable you to add and read entries in the log. They cannot be saved or deleted. For more information about audit entries and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: AuditBridge Axeda Platform Axeda v2 API/Services Developer s Reference: AuditBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: AuditBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/auditbridge.html Creates an audit based on the audit property values. Finds an audit based on an identifier. Finds audits that match the specified search criteria. Finds audits based on audit identifiers in the request body. Finds the first audit that matches the specified criteria. Creates an audit. Creates one or more audits. Creates one or more audits. rest/audit rest/audit/id/systemid rest/audit/find rest/audit/findbyids rest/audit/findone rest/audit rest/audit/bulk/create rest/audit/bulk/save 19
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Custom Object APIs Custom object APIs enable you to create, read, update, and delete custom objects. Custom objects enable you to customize rules and actions on the EMS Server based on Groovy scripts or using the Scripto service. For more information about custom objects and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: CustomObjectBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: CustomObjectBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ CustomObjectBridge.html Verifies that a custom object compiles. Creates a custom object based on the custom object property values. Deletes a custom object. Finds a custom object based on an identifier. Finds custom objects that match the specified search criteria. Finds custom objects based on custom object identifiers in the request body. Returns the custom object with the specified system identifier. rest/customobject/compile rest/customobject DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/customobject/systemid rest/customobject/alternateid rest/customobject/find rest/customobject/findbyids rest/customobject/id/systemid 20
2 Mashery API Reference Custom Object Examples Finds the first custom object that matches the specified criteria. Creates or updates a custom object. properties of an existing custom object. Creates one or more custom objects. Deletes one or more custom objects. Creates or updates one or more custom objects. properties of one or more custom objects. rest/customobject/findone rest/customobject rest/customobject/id/systemid rest/customobject/bulk/create rest/customobject/bulk/delete rest/customobject/bulk/save rest/customobject/bulk/update Related Links Custom Object Examples on page 21 Custom Object examples demonstrate selected methods in XML format. Custom Object Examples Custom Object examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. find (by criteria) This example shows a request to find custom objects using a wildcard for the name (the criteria) in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/customobject/find? api_key=apikey" \ -d@customobject-findbycriteria.xml \ tidy --show-warnings no -xml -i -q 21
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 customobject-findbycriteria.xml <?xml version="1.0" encoding="utf-8"?> <CustomObjectCriteria xmlns="http://www.axeda.com/services/v2"> <name>customobject*</name> </CustomObjectCriteria> save This example shows a request to save a custom object of language type Groovy script. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/sandbox1/services/v1/rest/customobject? api_key=apikey" \ -d@customobject-save.xml \ tidy --show-warnings no -xml -i -q customobject-save.xml CustomObject xmlns="http://www.axeda.com/services/v2"> <name>customobjectsave</name> <type>action</type> <params> <customobjectparam> <variablename>var11367590998148</variablename> <displayname>displayname11367590998148</displayname> </customobjectparam> <customobjectparam> <variablename>var21367590998148</variablename> <displayname>displayname21367590998148</displayname> </customobjectparam> </params> <description>description1367590998148</description> <source>import com.axeda.*</source> <languagetype>groovy</languagetype> </CustomObject> Related Links Custom Object APIs on page 20 Custom object APIs enable you to create, read, update, and delete custom objects. Custom Object Group Object APIs Custom object group object APIs enable you to create, read, update, and delete custom object groups. A custom object group enables you to manage multiple custom objects as a group. For more information about custom object groups and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: CustomObjectGroupBridge Axeda Platform Axeda v2 API/Services Developer s Reference: CustomObjectGroupBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: CustomObjectGroupBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ CustomObjectGroupBridge.html 22
2 Mashery API Reference Custom Object Group Object APIs Creates a custom object group based on the custom object group property values. Deletes a custom object group. Finds a custom object group based on alternate identifier. Finds custom object groups that match the specified search criteria. Finds custom object groups based on identifiers in the request body. Returns the custom object group based on the specified system identifier. Finds the first custom object group that matches the specified criteria. Creates or updates a custom object group. properties of an existing custom object group. Creates one or more custom object groups. Deletes one or more custom object groups. rest/customobjectgroup DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/customobjectgroup/id/systemid rest/customobjectgroup/alternateid rest/customobjectgroup/find rest/customobjectgroup/findbyids rest/customobjectgroup/id/systemid rest/customobjectgroup/findone rest/customobjectgroup rest/customobjectgroup/id/systemid rest/customobjectgroup/bulk/create rest/customobjectgroup/bulk/delete 23
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Creates or updates one or more custom object groups. properties of one or more custom object groups. rest/customobjectgroup/bulk/save rest/customobjectgroup/bulk/update Data Item Object APIs Data item object APIs enable you to create, read, update, and delete data items on an asset or group of assets. Data items represent data sent between a device and the EMS server. Data items can be associated with an external data source, such as a sensor. The APIs operate on data items on the asset created using the Axeda Builder. For more information about data items and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Data Items Axeda Platform Axeda v2 API/Services Developer s Reference: DataItemsBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: DataItemsBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/dataitemsbridge.html Creates a data item based on the data item property values. Deletes a data item. Finds a data item based on alternate identifier. Finds a data item based on system identifier. rest/dataitem DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/dataitem/id/systemid rest/dataitem/alternateid rest/dataitem/id/systemid 24
2 Mashery API Reference Data Item Object APIs Finds data items that match the specified search criteria. Finds data items based on data item identifiers in the request body. Returns the current data item values. Finds the first data item that matches the specified criteria. Creates or updates a data item. Returns the historical values of a data item. properties of an existing data item. Creates one or more data items. Deletes one or more data items. Creates or updates one or more data items. properties of one or more data items. rest/dataitem/find rest/dataitem/findbyids rest/dataitem/findcurrentvalues rest/dataitem/findone rest/dataitem rest/dataitem/findhistoricalvalues rest/dataitem/id/systemid rest/dataitem/bulk/create rest/dataitem/bulk/delete rest/dataitem/bulk/save rest/dataitem/bulk/update Related Links Data Item Examples on page 26 25
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Data Item examples demonstrate selected methods in XML format. Data Item Examples Data Item examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. create This example shows a request to create a data item on an asset. The request body identifies the asset by the model id="windrivermodel". $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X PUT \ "https://windriver.api.mashery.com/servername/services/v1/rest/dataitem? api_key=apikey" \ -d@dataitem-create.xml \ tidy --show-warnings no -xml -i -q dataitem-create.xml <v2:dataitem xmlns:v2="http://www.axeda.com/services/v2"> <v2:name>testdataitem_deleteme</v2:name> <ns85:model id="windrivermodel" xsi:type="ns85:modelreference" xmlns:ns85="http:// www.axeda.com/services/v2" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"/> <v2:type>string</v2:type> </v2:dataitem> find (by identifier) This example shows a request to find a data item based on the system identifier specified in the REST call. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X GET \ "https://windriver.api.mashery.com/servername/services/v1/rest/dataitem/id/52? api_key=keyval" \ tidy --show-warnings no -xml -i -q findcurrentvalues This example shows a request to find current value of data items for the asset specified in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/dataitem/ findcurrentvalues?api_key=apikey" \ -d@dataitem-findcurrentvalues.xml \ tidy --show-warnings no -xml -i -q 26
2 Mashery API Reference Deployment Object APIs dataitem-findcurrentvalues.xml <v2:currentdataitemvaluecriteria sortascending="true" sortpropertyname="name" xmlns:v2="http://www.axeda.com/services/v2" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance"> <v2:assetid>42</v2:assetid> </v2:currentdataitemvaluecriteria> Related Links Data Item Object APIs on page 24 Data item object APIs enable you to create, read, update, and delete data items on an asset or group of assets. Deployment Object APIs Deployment object APIs enable you to create, read, update, and delete the objects that control software packages that are delivered to an EMS agent. Deployment objects control the deployment of software packages to an EMS agent running on an asset. Deployments must reference a software package. For more information about deployments and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Files and Packages Axeda Platform Axeda v2 API/Services Developer s Reference: DeploymentBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: DeploymentBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/deploymentbridge.html Cancels a deployment. Creates a deployment based on the deployment property values. Deletes a deployment. Finds deployments that match the specified search criteria. rest/deployment/id/systemid/cancel rest/deployment DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/deployment/id/systemid rest/deployment/find 27
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Finds deployments based on deployment identifiers in the request body. Returns a deployment with the specified system identifier. Finds the first deployment that matches the specified criteria. Redeploys a deployment. Creates or updates a deployment. properties of an existing deployment. Creates one or more deployments. Deletes one or more deployments. Creates or updates one or more deployments. properties of one or more deployments. rest/deployment/findbyids rest/deployment/id/systemid rest/deployment/findone rest/deployment/id/systemid/redeploy rest/deployment rest/deployment/id/systemid rest/deployment/bulk/create rest/deployment/bulk/delete rest/deployment/bulk/save rest/deployment/bulk/update Expression Rule Object APIs Expression rule object APIs enable you to create, read, update and delete expression rules. You use expression rules to evaluate a condition and take a specified action based on the value. The format of an expression rule is if-then-else. For more information about expression rules and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Expression Rules 28
2 Mashery API Reference Expression Rule Object APIs Axeda Platform Axeda v2 API/Services Developer s Reference: ExpressionRuleBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ExpressionRuleBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ ExpressionRuleBridge.html Creates an expression rule based on the expression rule property values. Deletes an expression rule. Finds an expression rule based on alternate identifier. Finds expression rules that match the specified search criteria. Finds expression rules based on expression rule identifiers in the request body. Returns the expression rule with the specified system identifier. Finds the first expression rule that matches the specified criteria. Creates or updates an expression rule. properties of an existing expression rule. rest/expressionrule DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/expressionrule/id/systemid rest/expressionrule/alternateid rest/expressionrule/find rest/expressionrule/findbyids rest/expressionrule/id/systemid rest/expressionrule/findone rest/expressionrule rest/expressionrule/id/systemid 29
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Validates the syntax of the expression rule. Creates one or more expression rules. Deletes one or more expression rules. Creates or updates one or more expression rules. properties of one or more expression rules. rest/expressionrule/validate rest/expressionrule/bulk/create rest/expressionrule/bulk/delete rest/expressionrule/bulk/save rest/expressionrule/bulk/update Related Links Expression Rule Examples on page 30 Expression Rule examples demonstrate selected methods in XML format. Expression Rule Examples Expression Rule examples demonstrate selected methods in XML format. The following examples show requests using the Linux curl command and show the request body in an XML file. create This example shows a request to create an expression rule with a DATA trigger. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X PUT \ "https://windriver.api.mashery.com/servername/services/v1/rest/expressionrule? api_key=keyval" \ -d@expressionrule-create.xml \ tidy --show-warnings no -xml -i -q expressionrule-create.xml <?xml version="1.0" encoding="utf-8"?> <ExpressionRule xmlns="http://www.axeda.com/services/v2"> <name>testexpressionrule</name> <type>data</type> <description>description</description> <ifexpression>true</ifexpression> <thenexpression>abs(1)</thenexpression> <elseexpression>now()</elseexpression> <consecutive>true</consecutive> <applytoall>false</applytoall> <enabled>false</enabled> 30
2 Mashery API Reference Extended Application Object APIs <standalone>true</standalone> </ExpressionRule> find (by criteria) This example shows a request to find an expression rule based on the rule name in the request body. $ curl -k --stderr /dev/null \ -i -H "Content-type: application/xml" \ -i -H "Accept: application/xml" \ -X POST \ "https://windriver.api.mashery.com/servername/services/v1/rest/expressionrule/find? api_key=keyval" \ -d@expressionrule-findbycriteria.xml \ tidy --show-warnings no -xml -i -q expressionrule-findbycriteria.xml <?xml version="1.0" encoding="utf-8"?> <ExpressionRuleCriteria xmlns="http://www.axeda.com/services/v2"> <name>testexpressionrule</name> </ExpressionRuleCriteria> Related Links Expression Rule Object APIs on page 28 Expression rule object APIs enable you to create, read, update and delete expression rules. Extended Application Object APIs Extended Applications APIs enable you to create, read, update and delete Rich Internet Application objects. Extended Applications are Rich Internet Applications (RIA) hosted on the EMS Server, and can be uploaded from the EMS Console. The contents can be displayed using extended UI modules. For more information about extended applications and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedApplicationBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedApplicationBridge: REST Examples Creates an extended application based on the extended application property values. rest/extendedapplication 31
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Deletes an extended application. Finds an extended application based on an alternate identifier. Finds extended applications that match the specified search criteria. Finds extended applications based on system identifiers in the request body. Returns the extended application based on the specified system identifier. Finds the first extended application that matches the specified criteria. Creates or updates an extended application. properties of an existing extended application. Creates one or more extended applications. Deletes one or more extended applications. Creates or updates one or more extended applications. properties of one or more extended applications. DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/extendedapplication/id/systemid rest/extendedapplication/alternateid rest/extendedapplication/find rest/extendedapplication/findbyids rest/extendedapplication/id/systemid rest/extendedapplication/findone rest/extendedapplication rest/extendedapplication/id/systemid rest/extendedapplication/bulk/create rest/extendedapplication/bulk/delete rest/extendedapplication/bulk/save rest/extendedapplication/bulk/update 32
2 Mashery API Reference Extended List Object APIs Extended List Object APIs Extended list object APIs enable you to create, read, update, and delete extended lists.. An extended list is an ordered list of up to 1000 unique string entries. For more information about extended lists and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedListBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedListBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ ExtendedListBridge.html Adds a value to an existing extended list. Creates an extended list based on the extended list property values. Deletes an extended list. Finds an extended list based on the alternate identifier, which is the same as the system identifier. Finds extended lists that match the specified search criteria. Finds extended lists based on extended list identifiers in the request body. PUT https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/alternateid PUT https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist DELETE https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/id/systemid GET https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/systemid POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/find POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/findbyids 33
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Returns the extended list based on the specified system identifier. Finds the first extended list that matches the specified criteria. Removes a value from an extended list. Creates or updates an extended list. properties of an existing extended list. Creates one or more extended lists. Deletes one or more extended lists. Creates or updates one or more extended lists. properties of one or more extended lists. GET https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/id/systemid POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/findone DELETE https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/id/systemid POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/id/systemid POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/bulk/create POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/bulk/delete POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/bulk/save POST https://windriver.api.mashery.com/servername/ services/v1/rest/extendedlist/bulk/update Extended Map Object APIs Extended map object APIs enable you to create, read, update and delete extended maps. An extended map is an ordered list of up to 1000 unique string name-value pairs. For more information about extended maps and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedMapBridge: Methods 34
2 Mashery API Reference Extended Map Object APIs Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedMapBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ ExtendedMapBridge.html Adds a value to an existing extended map. Creates an extended map based on the extended map property values. Deletes the contents of an extended map. Finds an extended map based on the alternate or system identifier, which are the same value. Finds extended maps that match the specified search criteria. Finds extended lists based on extended map identifiers in the request body. Finds the first extended map that matches the specified criteria. Creates one or more extended maps. Deletes the contents of one or more extended maps. Creates or updates one or more extended maps. rest/extendedmap/systemid/key rest/extendedmap DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/extendedmap/id/systemid rest/extendedmap/systemid rest/extendedmap/id/systemid rest/extendedmap/find rest/extendedmap/findbyids rest/extendedmap/findone rest/extendedmap/bulk/create rest/extendedmap/bulk/delete rest/extendedmap/bulk/save 35
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 properties of one or more extended maps. rest/extendedmap/bulk/update Extended UI Module Object APIs Extended UI Model object APIs enable you to create, read, update and delete extended UI modules. You use extended UI modules to create custom applications in the EMS Console using either custom objects or extended applications. For more information about Extended UI Modules and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedUIModuleBridge Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedUIModuleBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ExtendedUIModuleBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ ExtendedUIModuleBridge.html Creates an extended UI module based on the extended UI module property values. Deletes an extended UI module. Finds extended UI modules that match the specified search criteria. Finds extended UI modules based on extended UI module identifiers in the request body. rest/extendeduimodule DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/extendeduimodule/id/systemid rest/extendeduimodule/find rest/extendeduimodule/findbyids 36
2 Mashery API Reference External Credential Object APIs Returns the extended UI module based on the specified system identifier. Finds the first extended UI Module that matches the specified criteria. Creates or updates an extended UI module. properties of an existing extended UI Module. Creates one or more extended UI modules. Deletes one or more extended UI modules. Creates or updates one or more extended UI modules. properties of one or more extended UI modules. rest/extendeduimodule/id/systemid rest/extendeduimodule/findone rest/extendeduimodule rest/extendeduimodule/id/systemid rest/extendeduimodule/bulk/create rest/extendeduimodule/bulk/delete rest/extendeduimodule/bulk/save rest/extendeduimodule/bulk/update External Credential Object APIs External credential object APIs enable you to create, read, update and delete external credentials that determine access to the EMS Server. External credentials are name-value pairs, and can be applied to user groups. For more information about External Credentials and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ExternalCredentialBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ExternalCredentialBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/dataitemsbridge.html 37
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Creates an external credential based on the external credential property values. Deletes an external credential. Finds external credentials that match the specified search criteria. Finds external credentials based on external credential identifiers in the request body. Returns the external credential based on system identifier. Finds the first external credential that matches the specified criteria. Creates or updates an external credential. properties of an existing external credential. Creates one or more external credentials. Deletes one or more external credentials. Creates or updates one or more external credentials. rest/externalcredential DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/externalcredential/id/systemid rest/externalcredential/find rest/externalcredential/findbyids rest/externalcredential/id/systemid rest/externalcredential/findone rest/externalcredential rest/externalcredential/id/systemid rest/externalcredential/bulk/create rest/externalcredential/bulk/delete rest/externalcredential/bulk/save 38
2 Mashery API Reference File Info Object APIs properties of one or more external credentials. rest/externalcredential/bulk/update File Info Object APIs File info object APIs enable you to create, read, update and delete information about a file. File info objects contain information about a specific file. All files uploaded to the EMS server must have an associated file info object. For more information about file info and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Files and Packages Axeda Platform Axeda v2 API/Services Developer s Reference: FileInfoBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: FileInfoBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/fileinfobridge.html Creates a file info based on the file info property values. Deletes a file info. Finds file infos that match the specified search criteria. Retrieves file contents as a stream of bytes Returns the file upload progress. Lists the file info by criteria. Creates or updates a file info. rest/file DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/file/systemid rest/file/find rest/file/systemid/download rest/file/systemid/progress rest/file/list rest/file/save 39
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Creates or updates a file info and uploads its contents to the EMS Server. properties of a file info. Uploads file contents. rest/file rest/file/systemid rest/file/systemid/content File Upload Session Object APIs File upload session object APIs enable you to create and read file uploads sessions to manage file uploads. File sessions are used to manage file uploads, which must be associated with a file upload sessions. You cannot delete or updated a file upload session. For more information about file upload sessions and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Files and Packages Axeda Platform Axeda v2 API/Services Developer s Reference: FileUploadSessionBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: FileUploadSessionBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ FileUploadSessionBridge.html Creates a file upload session based on the file upload session property values. Finds a file upload session based on the system identifier. Finds file upload sessions that match the specified search criteria. rest/file/session rest/file/session/systemid rest/file/session/list 40
2 Mashery API Reference Location Object APIs Creates or updates a file upload session. rest/file/session/save Location Object APIs Location object APIs enable you to create, read, update, and delete location information for an asset. Organizations, locations, and regions organize assets. A location must be associated with an organization. For more information about locations and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: LocationBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: LocationBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/locationbridge.html Creates a location based on the location property values. Deletes a location. Finds locations that match the specified search criteria. Finds location based on location identifiers in the request body. Returns the location based on system identifier. Finds the first location that matches the specified criteria. Creates or updates a location. rest/location DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/location/id/systemid rest/location/find rest/location/findbyids rest/location/id/systemid rest/location/findone rest/location 41
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 properties of an existing location. Creates one or more locations. Deletes one or more locations. Creates or updates one or more locations. properties of one or more locations. rest/location/id/systemid rest/location/bulk/create rest/location/bulk/delete rest/location/bulk/save rest/location/bulk/update Machine Stream Object APIs Machine stream object APIs enable you to create, read, update, and delete access to raw streams of data from assets connected to the EMS Server. Machine streams can contain data items, alarms, registration, and location information from assets. Transport configuration are used to specify the transport and status of the stream. For more information about machine streams and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: MachineStreamBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: MachineStreamBridge: REST Examples Creates a machine stream based on the machine stream property values. Deletes a machine stream. rest/machinestream DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/machinestream/id/systemid 42
2 Mashery API Reference Machine Stream Object APIs Finds machine streams that match the specified search criteria. Returns the asset status for each asset in the specified machine stream. Returns the machine stream based on system identifier. Finds the first machine stream that matches the specified criteria. Creates or updates a machine stream. properties of an existing machine stream. Creates one or more machine streams. Deletes one or more machine streams. Creates or updates one or more machine streams. properties of one or more machine streams. rest/machinestream/find rest/machinestream/id/systemid/associatedassets rest/machinestream/id/systemid rest/machinestream/findone rest/machinestream rest/machinestream/id/systemid rest/machinestream/bulk/create rest/machinestream/bulk/delete rest/machinestream/bulk/save rest/machinestream/bulk/update 43
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Model Object APIs Model object APIs enable you to create, read, update, and delete asset models. A model represents assets of the same type with the same properties. You can specify the model name when you build the rootfs. If a device running the EMS agent starts the first time without a model name, one is automatically generated. For more information about models and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: ModelBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: ModelBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/modelbridge.html Creates a model based on the model property values. Deletes a model. Finds models that match the specified search criteria. Returns the model based on the system identifier. Finds the first model that matches the specified criteria. Creates or updates a model. properties of an existing model. Creates one or more models. rest/model DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/model/id/systemid rest/model/find rest/model/id/systemid rest/model/findone rest/model rest/model/id/systemid rest/model/bulk/create 44
2 Mashery API Reference Organization Object APIs Deletes one or more models. Creates or updates one or more models. properties of one or more models. rest/model/bulk/delete rest/model/bulk/save rest/model/bulk/update Organization Object APIs Organization object APIs enable you to create, read, update, and delete asset organization information. Organizations, locations, and regions organize assets. An organization must be associated with a location. For more information about organizations and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: OrganizationBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: OrganizationBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ OrganizationBridge.html Creates a organization based on the organization property values. Deletes a organization. Finds organizations that match the specified search criteria. Finds organizations based on organization identifiers in the request body. rest/organization DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/organization/id/systemid rest/organization/find rest/organization/findbyids 45
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Returns the organization based on system identifier. Finds the first organization that matches the specified criteria. Creates or updates a organization. properties of an existing organization. Creates one or more organizations. Deletes one or more organizations. Creates or updates one or more organizations. properties of one or more organizations. rest/organization/id/systemid rest/organization/findone rest/organization rest/organization/id/systemid rest/organization/bulk/create rest/organization/bulk/delete rest/organization/bulk/save rest/organization/bulk/update Region Object APIs Region object APIs enable you to create, read, update, and delete asset region information. You can use regions, locations, and organizations to organize assets. A location must be associated with an organization before it can be associated with a region. For more information about regions and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: RegionBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: RegionBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/regionbridge.html 46
2 Mashery API Reference Region Object APIs Creates a region based on the region property values. Deletes a region. Finds regions that match the specified search criteria. Finds regions based on region identifiers in the request body. Returns the region based on system identifier. Finds the first region that matches the specified criteria. Creates or updates a region. properties of an existing region. Creates one or more regions. Deletes one or more regions. Creates or updates one or more regions. properties of one or more regions. rest/region DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/region/id/systemid rest/region/find rest/region/findbyids rest/region/id/systemid rest/region/findone rest/region rest/region/id/systemid rest/region/bulk/create rest/region/bulk/delete rest/region/bulk/save rest/region/bulk/update 47
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Remote Server Object APIs Remove server object APIs enable you to read information about remote access servers. Remote servers enable you to access an asset through a remote session. For more information about remote servers and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: RemoteServerBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: RemoteServerBrdige: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ RemoteServerBridge.html Finds remote servers that match the specified search criteria. Returns the remote server based on system identifier. Finds the first remote server that matches the specified criteria. Finds remote server best able to handle the session with the specified system identifier. rest/remoteserver/find rest/remoteserver/id/systemid rest/remoteserver/findone rest/remoteserver/find Remote Session Object APIs Remote session object APIs enable you to create, read, update, and delete remote sessions to communicate with remote assets. Remote sessions enable communication with assets that do not have a graphical user interface and are behind a firewall. For more information about remote sessions and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: RemoteSessionBridge: Methods 48
2 Mashery API Reference Remote Session Object APIs Axeda Platform Axeda v2 API/Services Developer s Reference: RemoteSessionBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ RemoteSessionBridge.html Creates a remote session based input parameters. Deletes the history of a remote session. Ends a remote session Finds an active remote interface by asset alternate or system identifier. Finds a remote interface by system identifier. Finds remote sessions that match the specified search criteria. Finds remote sessions based on remote session identifiers in the request body. Returns the remote session based on system identifier. Finds the first remote session that matches the specified criteria. rest/remotesession DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/remotesession/id/systemid rest/remotesession/id/systemid/end rest/remotesession/interfaces/asset/alternateid rest/remotesession/interfaces/asset/id/systemid rest/remotesession/interface/id/systemid rest/remotesession/find rest/remotesession/findbyids rest/remotesession/id/systemid rest/remotesession/findone 49
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Returns the remote client information for the specified remote interface based on system identifier. Returns the status of the remote session. Joins a remote session. Leaves a remote session Merges a remote session with an existing remote session specified by the system identifier. Validates a user for a remote session. Deletes one or more remote sessions. rest/remotesession/clientinfo/interface/id/systemid rest/remotesession/id/systemid/status rest/remotesession/id/systemid/join rest/remotesession/id/systemid/leave rest/remotesession/id/systemid/merge rest/remotesession/id/systemid/isuservalid rest/remotesession/bulk/delete Self Service Object APIs Self service object APIs enable users to manage their passwords. For more information about self services and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: SelfServiceBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: SelfServiceBrdige: REST Examples Changes the user's password. rest/self/password 50
2 Mashery API Reference Software Package Object APIs Provides the user with the password validation policy. Validates the user's password against the password validation policy. rest/self/password/validationpolicy rest/self/password/validate Software Package Object APIs Software package object APIs enable you to create, read, update, and delete software packages. Software pacakges contain instructions and other information about delivering software to EMS agents. For more information about software packages and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Files and Packages Axeda Platform Axeda v2 API/Services Developer s Reference: SoftwarePackageBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: SoftwarePackageBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ SoftwarePackageBridge.html Creates a software package based on the software package property values. Deletes a software package. Finds software packages that match the specified search criteria. Returns the software package based on the system identifier. rest/softwarepackage DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/softwarepackage/id/systemid rest/softwarepackage/find rest/softwarepackage/id/systemid 51
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Finds the first software package that matches the specified criteria. Creates or updates a software package. properties of an existing software package. Creates one or more software packages. Deletes one or more software packages. Creates or updates one or more software packages. properties of one or more software packages. rest/softwarepackage/findone rest/softwarepackage rest/softwarepackage/id/systemid rest/softwarepackage/bulk/create rest/softwarepackage/bulk/delete rest/softwarepackage/bulk/save rest/softwarepackage/bulk/update Transport Configuration Object APIs Transport configuration object APIs enable you to create, read, update and delete transport objects. Transport configurations are used by machine streams. Only Adminstrators on the EMS Server can use transport configuration. For more information about Data Items and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: TransportConfigurationBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: TransportConfigurationBridge: REST Examples 52
2 Mashery API Reference Unit Of Measure Object APIs Creates a transport configuration based on the transport configuration property values. Deletes a transport configuration. Finds transport configurations that match the specified search criteria. Returns the transport configuration based on system identifier. Creates or updates a transport configuration. properties of an existing transport configuration. rest/transportconfiguration DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/transportconfiguration/id/systemid rest/transportconfiguration/find rest/transportconfiguration/id/systemid rest/transportconfiguration rest/transportconfiguration/id/systemid Unit Of Measure Object APIs Unit of measure object APIs enable you to create, read, update, and delete units of measure for data item values. For more information about units of measure and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: UnitOfMeasureBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: UnitOfMeasureBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ UnitOfMeasureBridge.html 53
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Creates a unit of measure based on the unit of measure property values. Deletes a unit of measure. Finds unit of measures that match the specified search criteria. Returns the unit of measure based on system identifier. Finds the first unit of measure that matches the specified criteria. Creates or updates a unit of measure. properties of an existing unit of measure. Creates one or more unit of measures. Deletes one or more unit of measures. Creates or updates one or more unit of measures. properties of one or more unit of measures. rest/unitofmeasure DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/unitofmeasure/id/systemid rest/unitofmeasure/find rest/unitofmeasure/id/systemid rest/unitofmeasure/findone rest/unitofmeasure rest/unitofmeasure/id/systemid rest/unitofmeasure/bulk/create rest/unitofmeasure/bulk/delete rest/unitofmeasure/bulk/save rest/unitofmeasure/bulk/update 54
2 Mashery API Reference User Object APIs User Object APIs User object APIs enable you to create, read, update, and delete user accounts on the EMS Server. Users define thc properties of a user on the EMS Server. Users belong to user groups and have privileges defined in the user privileges object. For more information about users and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Users Axeda Platform Axeda v2 API/Services Developer s Reference: UserBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: UserBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/userbridge.html Creates a user based on the user property values. Deletes a user. Sets a user's password state to expired. Finds a user based on the alternate identifier. Finds a user based on the system identifier. Finds users that match the specified search criteria. Finds users based on user identifiers in the request body. Returnes the validation policy of a user's password. rest/user DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/user rest/user/alternateid/password/expire rest/user/alternateid rest/user/id/systemid rest/user/find rest/user/findbyids rest/user/password/validationpolicy 55
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Finds the first user that matches the specified criteria. Creates or updates a user. Resets a user's password properties of an existing user. Unlocks a user. Create one or more users. Deletes one or more users. Creates or updates one or more users. properties of one or more users. rest/user/findone rest/user rest/user/alternateid/password/resetrequest rest/user/id/systemid rest/user/alternateid/unlock rest/user/bulk/create rest/user/bulk/delete rest/user/bulk/save rest/user/bulk/update User Group Object APIs User group object APIs enable you to create, read, update, and delete user group information. A user group is a pool of users with common access privileges on the EMS Server. For more information about user groups and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: UserGroupBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: UserGroupBridge: REST Examples 56
2 Mashery API Reference User Group Object APIs Creates a user group based on the user group property values. Deletes a user group. Finds user groups that match the specified search criteria. Finds user groups based on user group identifiers in the request body. Returns the user group based on system identifier. Finds the first user group that matches the specified criteria. Creates or updates a user group. properties of an existing user group. Creates one or more user groups. Deletes one or more user groups. Creates or updates one or more user groups. properties of one or more user groups. rest/usergroup DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/usergroup/id/systemid rest/usergroup/find rest/usergroup/findbyids rest/usergroup/id/systemid rest/usergroup/findone rest/usergroup rest/usergroup/id/systemid rest/usergroup/bulk/create rest/usergroup/bulk/delete rest/usergroup/bulk/save rest/usergroup/bulk/update 57
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 User Privilege Object APIs User privilege object APIs enable you to create, read, update, and delete user privilege information. A user privilege object enables a user on the EMS Server to assign custom privileges to user groups on the EMS Server. For more information about user privileges and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: UserPrivilegeBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: UserPrivilegeBridge: REST Examples Creates a user privilege based on the user privilege property values. Deletes a user privilege. Finds user privileges that match the specified search criteria. Finds user privileges based on user privilege identifiers in the request body. Returns the user privilege based on system identifier. Finds the first user privilege that matches the specified criteria. Checks if a user has the specified privilege. rest/userprivilege DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/userprivilege/id/systemid rest/userprivilege/find rest/userprivilege/findbyids rest/userprivilege/id/systemid rest/userprivilege/findone rest/userprivilege/privilegename/hasprivilege 58
2 Mashery API Reference User Settings APIs Creates or updates a user privilege. properties of an existing user privilege. Creates one or more user privileges. Deletes one or more user privileges. Creates or updates one or more user privileges. properties of one or more user privileges. rest/userprivilege rest/userprivilege/id/systemid rest/userprivilege/bulk/create rest/userprivilege/bulk/delete rest/userprivilege/bulk/save rest/userprivilege/bulk/update User Settings APIs User settings object APIs enable you to create, read, update, and delete settings in the user layer of the EMS server. The user layer contains the settings for each user. For more information about user settings and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: Platform Settings Axeda Platform Axeda v2 API/Services Developer s Reference: UserSettingsBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: UserSettingsBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ UserSettingsBridge.html Deletes PlatformSettings. Finds a setting. DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/settings/user rest/settings/user 59
Wind River Intelligent Device Platform XT EMS Profile Wind River EMS Device Management User's Guide, 1.0 Finds PlatformSettings that match all settings in the specified path. Creates or updates PlatformSettings. rest/settings/user rest/settings/user/save Web Resource Object APIs Web resource object APIs enable you to automatically generate client classes from web services WSDLs. You can use web resources to upload Groovy scripts to the EMS Server and configure them as custom objects. For more information about web resources and the available APIs, see the following: Axeda Platform Axeda v2 API/Services Developer s Reference: WebResourcesBridge: Methods Axeda Platform Axeda v2 API/Services Developer s Reference: WebResourcesBridge: REST Examples https://mentor.axeda.com/javadoc/6_6-sdk_javadoc/com/axeda/sdk/v2/bridge/ WebResourceBridge.html Creates a web resource based on the web resource property values. Deletes a web resource. Finds web resources that match the specified search criteria. Finds web resources based on web resource identifiers in the request body. rest/webresource DELETE https://windriver.api.mashery.com/servername/services/v1/ rest/webresource/id/systemid rest/webresource/find rest/webresource/findbyids 60
2 Mashery API Reference Web Resource Object APIs Returns the web resource based on system identifier. Finds the first web resource that matches the specified criteria. Creates or updates a web resource. properties of an existing web resource. Creates one or more web resources. Deletes one or more web resources. Creates or updates one or more web resources. properties of one or more web resources. rest/webresource/id/identifier rest/webresource/findone rest/webresource rest/webresource/id/systemid rest/webresource/bulk/create rest/webresource/bulk/delete rest/webresource/bulk/save rest/webresource/bulk/update 61