In Part 1, we discussed why migration is painful in real life — not because exporting/importing is difficult, but because we rarely know exactly what changed between environments. Oracle’s April 2026 update addresses this by introducing a set of Migration REST APIs designed for programmatic lifecycle management.
Part1 focused on the foundational capabilities:
- Discovering artifact
categories
- Listing artifacts per
category
- Exporting incremental
category-level backups
Now
in Part 2, we’ll cover the APIs that answer the questions every admin
eventually faces:
- What changed since the
last release?
- What changed after a
snapshot was created?
- What exactly is inside a
snapshot before I import it?
- How do I control group
import behavior?
- Did my migration really
succeed (with errors/warnings visibility)?
These
are all explicitly called out in Oracle’s “New Migration REST APIs” note for
April 2026.
The
lifecycle flow (how these APIs fit together)
Here’s
the practical way to think about the new approach:
Discover
→ Detect changes → Export/Import intentionally → Validate via status
Oracle
lists APIs across these themes — categories/artifacts, updated artifacts,
snapshot details/history, import options, and migration status.
1) List Updated Artifacts – Identify what changed in a date range
This
is one of the most practical additions.
Oracle
states that List Updated Artifacts lists application artifacts modified
within a specified date range, similar to the Artifact Updates Report.
Why
this matters (real-world)
This
is what prevents “blind” migrations.
Instead
of:
“Let’s
migrate the whole snapshot because something might have changed…”
You
can do:
“Show
me what changed from last release window — and migrate only that.”
Postman
Example: List Updated Artifacts
2)
Get Snapshot Modification History – Catch snapshot drift
Oracle
states that Get Snapshot Modification History lists artifacts modified
after a snapshot was originally created, similar to the Modification History
report.
Why
admins care
Snapshots
are often assumed to be “the truth”, but environments evolve after snapshots
are taken. This API helps you detect what moved after the snapshot, so
you can create a new snapshot (or incremental export) that includes only the
missing changes.
3)
List Snapshot Details – Make snapshots transparent before importing
Oracle
states that List Snapshot Details provides the categories within
snapshots available in the environment and the actions that can be performed on
them.
This
makes snapshots less of a black box. You can programmatically validate that the
snapshot actually contains the categories you expect, before importing.
Postman
Example: List Snapshot Details
4)
List Artifacts in a Snapshot – Validate artifacts inside snapshot by category
Oracle
states that List Artifacts in a Snapshot gets a list of all artifacts of
a specified category within a snapshot.
Why
this matters
You
can now validate:
- Which Planning artifacts
exist inside a snapshot
- Whether a category
export/snapshot includes the objects you intended
- Whether anything
unexpected appears in the snapshot before importing
5)
List Import Options / Set Import Options – Control group membership import
behavior
Oracle
states:
- List Import Options retrieves effective
import options for groups and group membership information available in
snapshots.
- Set Import Options sets how group membership
import is handled during import of groups from a snapshot or file.
This
is important because security migrations can surprise teams if group membership
import behavior differs between environments. These APIs let you standardize
that behavior programmatically.
6)
Get Migration Status – Prove the migration outcome (success / warnings /
errors)
Oracle
states that Get Migration Status retrieves information on artifact
migrations that were performed, similar to the Migration Status report.
That
means migrations become observable — a key requirement for automation.
Postman
Example: Get Migration Status
Quick
recap – APIs introduced under “New Migration REST APIs” (April 2026)
Oracle
lists the following new Migration REST APIs:
- Get Artifact Categories
- List Artifacts in a
Category
- Export Categories
Artifacts (incremental backup)
- List Updated Artifacts
- List Snapshot Details
- Get Snapshot Modification
History
- List Artifacts in a
Snapshot
- List Import Options
- Set Import Options
- Get Migration Status
Final thoughts
This
is one of the strongest lifecycle-management updates Oracle has delivered for
Cloud EPM in a long time.
The
message is clear: migrations don’t need to be “big snapshot pushes” anymore.
With April 2026, Oracle is enabling a controlled approach:
- detect change
- export incrementally
- inspect snapshot contents
- control import behavior
for groups
- validate execution via
migration status
If your team is serious about repeatable releases and reduced migration risk, these APIs are worth exploring immediately.
Happy Days on the Cloud!
No comments:
Post a Comment