Rate this page:
This page includes release notes and updates about the App migration platform for individuals who develop migration paths to move app data from server/data center to cloud.
Use this page to keep track of new or updated features, deprecations, and bug fixes.
Server side listener failures can cause an app migration look stuck for long hours, as their cloud apps may not be aware of server side listener failures and miss setting a proper status to such app migrations.
To close this gap, App migration platform is introducing,
a new web hook event type (
listener-errored) to notify the cloud apps when there is a server side listener failure
a new connect end point to fetch details about the server side failure
You can read more details about this feature here.
This feature will be released in few weeks (ETA : mid November 2022) and will be available for app migrations using CCMA v3.3.7 and JCMA v1.7.2 onwards.
We are experimenting with a feature to cancel stuck transfers. Cloud apps may receive a new event with the type
As the platform evolves to cover more exceptional cases, in future there might be also events to notify marketplace partners that there was an error on their server-side migration listener.
We are starting to phase out our first-generation app migration listeners (
CloudMigrationListenerV1) in favour of
If your app has dependencies on either of the first-generation app migration libraries (
app-migration-tracker), you are required to plan for some changes if you intend to keep supporting App migrations.
Following the announcement at MIG-812, the User Impersonation requirement to use the following Bulk APIs will be removed:
The Jira Cloud platform REST API - Bulk update custom field value
The Jira Cloud platform REST API - Bulk update entity properties
Requests made with User Impersonation will have their impersonation ignored.
Updated documentation to provide more details on possible 429 from calls made to App migration platform from cloud app.
For more details, refer to: https://developer.atlassian.com/platform/app-migration/rate-limiting/
Following tutorials are updated to remove the need to impersonate a user in order to use the Jira bulk APIs for entity properties and custom fields.
Refer to https://jira.atlassian.com/browse/MIG-812 for more details about this change.
On 16 May 2022, we will start to enforce the maximum limit of 5 HTTP registered endpoints to receive webhook events for each combination of appKey and cloud site done via a PUT request.
We have been monitoring the usage of this feature and we expect absolutely no customer impact. Every webhook registration observed in the last several weeks is under the limit we are going to impose.
This change will not impact previously registered endpoints.
The App migration platform public beta version is now available for Confluence Cloud Migration Assistant to use in production.
Discoverable Listener is now available for use in production as the following issues were fixed:
From 19 May 2022, the App migration platform will reduce the maximum page size to 1200 for mapping retrieval operations for both server and cloud app.
Read the Deprecation notice for page size of APIs to get the mappings by pages for more information.
We have added two new tutorials to help with migrating from the
atlassian-app-cloud-migration-tracker library to the Discoverable Listener.