Upcoming API Deprecations and Modifications

What does this mean to Asset Customers

GE Digital appreciates and values your business. As part of our efforts to continuously improve our product offerings, APM Asset Service is upgrading its S95 model to allow for automatic Tag ingestion from Edge devices (like OSM, OSI-PI, Historian) to APM cloud.

As a result of this upgrade, Asset Service API endpoints that allow creating and querying Tags will be deprecated and replaced with new set of API endpoints by March 2022 (subject to change to a future date).

Find below preliminary list of API endpoints that will be deprecated by March 2022 (subject to change to a future date). This communication is to identify customers who are invoking Asset Service endpoints for Tag create and Tag query.

API endpoints being deprecated in Q1 2022 – both /V1 and /V3

• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv3.html#associate-tags-to-asset
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv3.html#disassociate-tags-from-asset
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv3.html#get-by-criteria
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv3.html#query-tags
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#associate-tags-to-asset
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#disassociate-tags-from-asset
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#get-by-criteria
• https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#query-tags

What will happen to existing data?

Tag data will be migrated to the upgraded S95 model.

What other changes are expected?

Tag Type inheritance of attributes to Tag instances will not be supported, Tag ingestion format will change, there will be detailed communication sent in the near future to describe Full API deprecation list, changes to Tags UI in Asset microapp, Tag Ingestion, new API endpoints that allow for Querying Tags.

User Actions

If you are a user of APM Asset Service and are invoking API endpoints listed above for creating and querying Tag data, please reach out to the https://digitalsupport.ge.com/, so that we can make sure to keep you informed with details about the upcoming changes

Initial Notification Date: May 18, 2021