copyFromObjectStorage

将文件或备份快照从 Oracle Object Storage 存储桶复制到当前环境。

如果您正在复制备份快照,则此命令从对象存储桶复制该快照并在 Oracle Enterprise Performance Management Cloud 中提取其内容。

适用于

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

所需角色

服务管理员

用法

epmautomate copyFromObjectStorage USERNAME PASSWORD URL TARGET_FILE_NAME,其中:

  • USERNAME 是在 Oracle Object Storage Cloud 中具有所需访问权限的用户的 ID。

    对于在联合身份提供程序中创建的用户,请指定用户的全限定名称(例如 exampleIdP/jdoeexampleIdP/john.doe@example.com,其中 exampleIdP 是联合身份提供程序的名称)。对于其他用户,请提供用户 ID。

  • PASSWORD 是与用户关联的 Swift 密码或身份验证令牌。此密码与您用于登录到对象存储控制台的密码不同。身份验证令牌是 Oracle 生成的令牌,您可以将其与第三方 API 一起用于身份验证,例如与 Swift 客户端一起用于身份验证。有关创建此令牌的说明,请参阅 Oracle Cloud Infrastructure 文档 中的“创建身份验证令牌”。
  • URL 是 Oracle Object Storage Cloud 存储桶的 URL,包括存储桶名称和要复制的对象名称。

    URL 格式:

    https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name/object_name

    此 URL 的组成部分:
    • region_identifier 是 Oracle Cloud Infrastructure 托管区域。
    • namespace 是所有存储桶和对象的顶级容器。在创建帐户时,会为每个 Oracle Cloud Infrastructure 租户分配一个唯一的对象存储名称空间名称,该名称由系统生成而且不可变。租户的名称空间名称(例如,axaxnpcrorw5)在所有区域中有效。
    • bucket_name 是用于存储数据和文件的逻辑容器的名称。存储桶按区间进行组织和维护。系统生成的存储桶名称(例如, bucket-20210301-1359)反映当前的年份、月份、日期和时间。
    • object_name 是要从 Oracle Object Storage Cloud 复制的快照或文件的名称。此值必须与 Object Storage Cloud 中的对象完整名称完全匹配。不使用 .zip 等扩展名,除非对象名称包含它。

    有关详细信息,请参阅 Oracle Cloud Infrastructure 文档中的以下主题

  • TARGET_FILE_NAMEEPM 云环境中文件或快照的唯一名称。在复制快照时,请勿指定 ZIP 扩展名,以便可以将此文件名用于 importSnapshot 命令。

    超过 100 MB 的文件存储在 Oracle Object Storage 的逻辑目录中,该目录同时存储用于标识文件段的清单文件。按照 TARGET_FILE_NAME 指定逻辑目录的名称。

示例

在这些示例中,将 URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET 替换为采用如下格式的有效 URL:https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name/

  • 将名为 backup_Snapshot_12_05_20.zip 的快照从 Oracle Object Storage 存储桶复制到 EPM 云并对其进行重命名:

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_Snapshot_12_05_20.zip snapshot_from_osc

  • 将名为 backup_Snapshot_12_05_20 的快照从 Oracle Object Storage 存储桶复制到 EPM 云并对其进行重命名:

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_Snapshot_12_05_20 snapshot_from_osc

  • 将名为 backup_Snapshot_12_05_20 的快照从 Oracle Object Storage 存储桶复制到 EPM 云,不对其进行重命名:

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_snapshot_12_05_20 backup_snapshot_12_05_20

  • 将文件从 Oracle Object Storage 存储桶复制到 EPM 云

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/example_file.txt copied_from_osc.txt