How to Delete a Device Using Rest and Not Retire It in Performance Management

Products

• CA Spectrum

Issue/Introduction

Starting in NetOps 21.2.8 there is a new option that allows a user to retire or not retire a device in Performance Management when you manually delete it. Does this
  new feature extend to rest when deleting models?

(DELETE) http://<hostname><:portnumber>/spectrum/restful/model/<model_handle>

 

Environment

Release : 21.2.8+

Component : Spectrum OneClick

Cause

Retire a Device While Deleting
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/21-2/integrating/ca-performance-management-and-ca-spectrum.html#concept.dita_ea712e9d582c2470e1bd2bccb7ca3b87c23f1d6c_lifecycle

New Dialog to Retire or not (Dialog only shows if integrated with CAPM)

Resolution

The Rest interface does not fully have this option as of yet, to not retire the device in CAPM remove the device from the
    IP Domain Global Collection Prior to deleting the model.


1. Delete Association to Global Collection

Rest Call to destroy an association

(DELETE) http://<hostname><:port>/spectrum/restful/associations/relation/<rel_handle>/leftmodel/<LMhandle>/rightmodel/<RMhandle>


<rel_handle> - a model can either be statically added or dynamically added to a Global Collection, so one of the following two relations is needed (typically dynamicGlobalCollects)

dynamicGlobalCollects        0x0001003a   MANY_TO_MANY
staticGlobalCollects             0x0001003b   MANY_TO_MANY

<LMhandle> - the model handle of the IP Domain Global Collection
<RMhandle> - the model handle of the device to be deleted

Example Syntax
(DELETE) http://oneclickserver.acme.net:8080/spectrum/restful/associations/relation/0x0001003a/leftmodel/0x1000b38/rightmodel/0x1000b39

 

2. Now that the device has been removed from the IP Domain Global Collection destroy the device model

Delete the device model

(DELETE) http://<hostname><:portnumber>/spectrum/restful/model/<model_handle>


Example Syntax
(DELETE) http://oneclickserver.acme.net:8080/spectrum/restful/model/0x1000b39

Additional Information

The rest call might be updated in a later version to add an option to not retire the device, For now, it must be removed from the IP Domain GC to not have it retired.


DELETE associations
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/21-2/programming/web-services-api-reference/how-to-use-the-ca-spectrum-web-services-api/restful-resources-nouns/associations.html#concept.dita_d03fe2e108278a21db78ad03f95614754c65b243_DELETEassociations


DELETE model
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/spectrum/21-2/programming/web-services-api-reference/how-to-use-the-ca-spectrum-web-services-api/restful-resources-nouns/model.html#concept.dita_1d06a0d76f000e6edd18de492383983feefced4e_DELETEmodel