诊断 REST API 问题

使用本节中的说明可解决与 Oracle Enterprise Performance Management Cloud REST API 相关的问题。

适用于

Oracle Hyperion PlanningPlanning 模块自由形式Financial Consolidation and CloseTax ReportingAccount ReconciliationOracle Hyperion Profitability and Cost ManagementEnterprise Profitability and Cost ManagementOracle Enterprise Data Management CloudNarrative Reporting销售规划战略性人员规划

查找身份域

执行 REST API 时,请确保正确指定身份域

使用以下方法之一确定您的身份域

  • 查看环境的活动报表。身份域的名称显示在活动报表的左上角。请参阅《Oracle Enterprise Performance Management Cloud 管理员入门》中的“关于活动报表”。
  • 从用于访问环境的 URL 派生身份域。例如,在 URL https://epm-exampleDomain.epm.dataCenter.oraclecloud.com/epmcloud 中,身份域名称为 exampleDomain

解决在更改 EPM 云密码之后出现的脚本执行失败问题

您会从 oraclecloudadmin_ww@oracle.com 定期收到密码失效警告。更改密码后,使用旧 EPM 云凭据的脚本将无法运行。

如果使用了加密密码文件来运行脚本,请使用 encrypt EPM Automate 命令更新您的密码加密文件以反映新的密码。如果在脚本中使用了纯文本密码,请确保对其进行更新。

解决启用了 SSO 的标准环境中的会话失败问题

在标准环境中,您必须始终使用您的身份域凭据运行 REST API。如果您的服务配置了使用身份提供程序的 SSO,则无法使用您用于访问 EPM 云的 SSO(身份提供程序)凭据执行 REST API。

如果服务配置了 SSO,那么身份域管理员必须允许运行 REST API 的所有用户使用他们的身份域凭据进行登录。

请参阅以下信息源:

检查凭据

如果无法使用 REST API 登录到环境,请使用与 REST API 配合使用的凭据通过浏览器或 EPM Automate 登录到环境。如果您的登录尝试失败,请参阅“解决登录问题”。

解决启用 IP 允许列表的环境中的复制应用程序快照 API 失败问题

如果当前环境配置了 IP 允许列表,则在发出复制应用程序快照 API 时可能会出错。要修复此错误,请参阅“EPM 云数据中心和区域的出站 IP 地址”来找到您在复制应用程序快照 API 参数中指定的源环境的出站 IP 地址,并将其添加到当前环境的允许列表。

如果您要在当前环境所在的 Identity Cloud Service 中使用网络边界,则还必须在此网络边界中添加源环境所在的数据中心或区域的出站 IP 地址。或者,您可以选择仅在网络边界中添加数据中心或区域的出站 IP 地址,而不是在当前环境上设置允许列表。

解决启用 IP 允许列表的环境中从 SFTP 复制和复制到 SFTP API 错误问题

如果为 SFTP 服务器启用了 IP 允许列表,则必须将托管 EPM 云环境的 OCI 区域的出站 IP 地址添加到 SFTP 服务器的 IP 允许列表。有关 OCI(第 2 代)区域的出站 IP 地址,请参阅《Oracle Enterprise Performance Management Cloud 运维指南》中的“EPM 云数据中心和区域的出站 IP 地址”。

寻求帮助

如果您可以使用浏览器或 EPM Automate 登录,但不能通过 REST API 登录,或者如果您可以使用 REST API 登录,但在使用 API 时报告了一个错误,请联系 Oracle 技术支持寻求帮助。
  1. 创建“提供反馈”提交。或者,通过同意应用程序快照提交,允许 Oracle 访问环境的维护快照。请参阅“创建一个“提供反馈”提交”。
  2. 创建一个确定“提供反馈”参考编号的技术服务请求。请参阅“提交技术服务请求”。服务请求必须包含以下附加信息:
    • REST API URL、用户名、有效负载、查询参数和标头。
    • 您收到的错误消息。
    • 此问题是在完成最近的月度更新后开始出现的吗?
    • 这是严重中断吗?