renameSnapshot

Renames a snapshot that you uploaded or a created in an environment.

If this command is executed to rename a snapshot that is in the process of being generated or archived, you will receive one of these errors:

  • File not found if the snapshot is being generated
  • Archive process is in progress. Unable to Rename or Delete if the snapshot is being archived

Do not rename the maintenance snapshot in an environment. To maintain a backup of the maintenance snapshot, you should download Artifact Snapshot from the environment to a local computer and then rename it as needed. See Overview of the Maintenance Snapshot in Getting Started with Oracle Enterprise Performance Management Cloud for Administrators.

Applies to

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management,Oracle Enterprise Data Management Cloud, Sales Planning, and Strategic Workforce Planning.

Required Roles

Service Administrator, Power User assigned to the Migration Administrator application role

Usage

epmautomate renameSnapshot SNAPSHOT_NAME NEW_SNAPSHOT_NAME where:
  • SNAPSHOT_NAME is the name of an existing snapshot. This value should not contain special characters such as space, \ (backslash), / (slash), * (asterisk), ? (question mark), " (quotation mark), < (less than), and > (greater than).

  • NEW_SNAPSHOT_NAME is the unique name you want to assign to the snapshot.

Example

epmautomate renameSnapshot "Example Snapshot" Example_Snapshot_18_09_25