Restoring a Pinned App with the API
If you have pinned a prior version of an app, you can overwrite the current version of the app with the pinned version. If the current app is not working correctly, rolling back to a prior version of the app may solve the issue.
Considerations
- After restoring a pinned app, you must scale the app down and back up to display the restored version of the app in the user interface.
- If you restore an app after a software upgrade, newer features may not work with the restored app, such as a new engine variable.
- If you repush the app, the app reverts to the most recent version of the app, not the pinned version of the app.
- When you restore a pin, the PIN RESTORED action is recorded and displays in the App Details History tab for the selected app.
To restore a pinned app, you need the following:
- Subscription Locator — The Subscription Locator of the Organization you want to access. To find Subscription Locators for your organizations use the
GET /v1/userinfomethod to return a list of all of the organizations for your OAuth Token with their Subscription Locators. You can use 0 as the Subscription Locator for the organization that owns the OAuth token. - App ID — ID of the app to be accessed, which can be retrieved using the
GET /v1/subscriptions/{subscriptionLocator}/appsmethod.
- Use the
PUT /v1/subscriptions/{subscriptionLocator}/apps/{appId}/pinmethod to overwrite the current version of the app with the pinned version. - Log into the TIBCO Cloud™ Integration user interface.
- Navigate to the Apps List and select the app you restored.
- Scale the app down to zero instances and then scale it back up to the correct number of instances. Note: If you do not scale the app down and back up again, the restored version of the app does not display in the user interface.
TIBCO Cloud Integration - Connect has a separate API that allows you to manage objects for that capability. The TIBCO Cloud Integration - Connect API can restore prior versions of flows within an app. For more information, see the help for GET /v1/orgs/{orgId}/solutions/{solutionId}/maps/{mapId}/revisions and POST /v1/orgs/{orgId}/solutions/{solutionId}/maps/{mapId}/revert under Maps in the TIBCO Cloud Integration - Connect Developer Portal.
Role Requirements
Only Admin users can restore pinned apps.