Updating Lifecycle of an Item of Equipment

While creating a piece of equipment you have option to create it in either ‘Planned’ , 'Fully Operational', 'Partially Operational', or ‘Not Operational’ state. You create a piece of equipment in Planned state when you do not have the physical instance of equipment.

You update the lifecycle of the equipment from Planned to other states when you receive the physical instance of the equipment.

You use this API to update the equipment lifecycle. The lifecycle phase changes for a piece of equipment are as follows:

  • Planned → Fully Operational or Partially Operational

  • Fully Operational → Partially Operational or Not Operational

  • Partially Operational → Fully Operational or Not Operational

  • Not Operational → Fully Operational, Partially Operational, Dispose, Retire, or Sold

  • Dispose → Fully Operational or Partially Operational or Retire

  • Retire → Sold

Request

  • HTTP Method: PUT

  • URL: Application_URL/services/api/v1/equipment({equipmentId})/changelifecycle?lifecycle=<LIFECYCLE>

  • Query Parameter: lifecycle

    lifecycle: specifies the value of the lifecycle that you want to change to. Possible value is 2.

  • Example URL: Application_URL/services/api/v1/equipment(E0B15BE85E2B41FBA06069B8D61CEB09)/changelifecycle?lifecycle=2

  • Authorization: You must have the roles EQUIPMENT_EDIT or EQUIPMENT_DELETE assigned to your user IDin the SAP Cloud Platform account.

  • Request Schema: To know about fields that you can use in a request payload, refer to the request schema in the https://help.sap.com/doc/040d5297b6804c3b903ee307cfcbf13c/1902/en-US/equipment.html#equipment__equipmentId___changelifecycle_put file.

Response