Diagnosing REST API Issues

Use the instructions in this section to resolve issues related to Oracle Fusion Cloud Enterprise Performance Management REST APIs.

Applies to

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

Finding Your Identity Domain

Ensure that you are correctly specifying your identity domain when executing REST APIs.

Use one of the following methods to identify your identity domain:

  • Look in the Activity Report for your environment. The name of the identity domain is displayed at the top left corner of the Activity Report. See About the Activity Report in Getting Started Guide for Administrators.
  • Derive the identity domain from the URL that you use to access the environment. For example, in the URL https://epm-exampleDomain.epm.dataCenter.oraclecloud.com/epmcloud, the identity domain name is exampleDomain.

Resolving Script Execution Failures After Changing the Cloud EPM Password

You will receive periodic password expiry warnings from oraclecloudadmin_ww@oracle.com. after changing your password, scripts that use your old Cloud EPM credentials will fail to run.

If you use an encrypted password file to run scripts, update your password encryption file using the encrypt EPM Automate command to reflect the new password. If you use plain text passwords in scripts, be sure to update them.

Checking Your Credentials

If you cannot sign in to your environment using REST API, use the credentials you are using with REST API to sign into the environment using a browser or EPM Automate. If your sign in attempt fails, see Resolving Login Issues.

Resolving Copy Application Snapshot API Failures in IP Allowlist-Enabled Environments

If the current environment has IP allowlist configured, you may get an error while issuing Copy Application Snapshot API. To fix it, see Outbound IP Addresses of Cloud EPM Regions to identify the outbound IP address of the source environment that you specified in the Copy Application Snapshot API parameter and add it to the allowlist of the current environment.

If you are using a network perimeter in the Identity Cloud service where the current environment is located, you must add the outbound IP address of the region where the source environment is located in this network perimeter as well. Alternatively, you can opt to add the outbound IP address of the region only in the network perimeter and not set up an allowlist on the current environment.

Resolving Copy from SFTP and Copy to SFTP API Error in IP Allowlist-Enabled Environments

If IP allowlist is enabled for the SFTP server, you must add the outbound IP address of the OCI region that hosts the Cloud EPM environments to the IP allowlist of the SFTP server. See Outbound IP Addresses of Cloud EPM Regions for the outbound IP addresses that you can use.

Seeking Help

If you can sign in using a browser or EPM Automate, but not through REST APIs or if you can sign in using REST API but an error is reported in using an API, contact Oracle Support for help.
  1. Create a Provide Feedback submission. Optionally, allow Oracle to access the maintenance snapshot of the environment by consenting to application snapshot submission. See Creating a Provide Feedback Submission.
  2. Create a technical service request that identifies the Provide Feedback reference number. See Submitting a Technical Service Request. The service request must contain the following additional information:
    • The REST API URL, user name, payload, query parameters, and headers.
    • Error messages that you received.
    • Did this issue start after the latest monthly update?
    • Is this is a critical outage?