Upcoming API Deprecations and Modifications

APM Asset Network and APM Asset Equipment Template Deprecation

Service(s) / Version(s)APM Asset Network and APM Asset Equipment Template
Effective DatePending
Affected Points of PresenceUS-West, EU Central, and GovCloud

APM Asset: Network Feature

The Network feature will be temporarily disabled in the APM application while we evaluate customer usage and potential improvements to the feature. The current plan is to reintroduce a functionally equivalent feature in a subsequent release. Please plan to discontinue usage after Q1, 2019 to ensure these changes do not impact your operations.

The following endpoints will be disabled:

  1. /v1/networks
  2. /v3/networks
  3. /v1/networks/{uuid}/nodes
  4. /v3/networks/{uuid}/nodes
  5. /v1/networks/{uuid}/edges
  6. /v3/networks/{uuid}/edges
  7. /v1/networks/{uuid}
  8. /v3/networks/{uuid}
  9. /v1/networks/{uuid}/edges/{uuid}
  10. /v3/networks/{uuid}/edges/{uuid}
  11. /v1/networks?components={parameter}
  12. /v3/networks?components={parameter}
  13. /v1/networks/{uuid}?components=FULL
  14. /v3/networks/{uuid}?components=FULL
  15. /v1/networks/query?q={parameters}
  16. /v3/networks/query?q={parameters}

Users can find more information about these endpoints and the current functionality they provide in the APM Asset API documentation at https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html%20-%20_networks

APM Asset: Equipment Template Feature

The Equipment Template feature will be temporarily disabled in the APM application while we evaluate customer usage and potential improvements to the feature. This deprecation will also include API’s related to creating, updating, and previewing Equipment Instances that have been instantiated using an Equipment Template. The current plan is to reintroduce a functionally equivalent feature in a subsequent release. Please plan to discontinue usage after Q1 to ensure these changes do not impact your operations.

The following Equipment Template endpoints will be disabled:

  1. /v1/assetTemplates
  2. /v3/assetTemplates
  3. /v1/assetTemplates?components={parameter]
  4. /v3/assetTemplates?components={parameter]
  5. /v1/assetTemplates?sourceKey={parameter}&components={parameters}
  6. /v3/assetTemplates?sourceKey={parameter}&components={parameters}
  7. /v1/assetTemplates/{uuid}?components={parameter}
  8. /v3/assetTemplates/{uuid}?components={parameter}
  9. /v1/assetTemplates/query?components={parameters}
  10. /v3/assetTemplates/query?components={parameters}
  11. /v1/assetTemplates/{uuid}
  12. /v3/assetTemplates/{uuid}
  13. /v1/assetTemplates/{uuid}/tags
  14. /v3/assetTemplates/{uuid}/tags
  15. /v1/assetTemplates/{uuid}/placeholders/{parameter}tags
  16. /v3/assetTemplates/{uuid}/placeholders/{parameter}tags

The following Equipment Instance endpoints will be disabled:

  1. /v1/equipmentInstances?op=preview
  2. /v3/equipmentInstances?op=preview
  3. /v1/equipmentInstances?op=create
  4. /v3/equipmentInstances?op=create
  5. /v1/equipmentInstances/{uuid}
  6. /v3/equipmentInstances/{uuid}

Users can find more information about these endpoints and the current functionality they provide in the APM Asset API documentation links below.

Equipment Templates: https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#_templates

Equipment Instances: https://apm-asset-apidoc-svc-prod.app-api.aws-usw02-pr.predix.io/docs/indexv1.html#_equipment_instances

For further information, please visit our support site https://digitalsupport.ge.com

Initial Notification Date: February 26, 2019