将文件或备份快照从 Oracle Object Storage 存储桶复制到当前环境。
如果您正在复制备份快照,则此命令从对象存储桶复制该快照并在 Oracle Enterprise Performance Management Cloud 中提取其内容。
适用于
Planning、Planning 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、Narrative Reporting、战略性人员规划和销售规划。
所需角色
服务管理员
用法
epmautomate copyFromObjectStorage USERNAME PASSWORD URL TARGET_FILE_NAME
,其中:
USERNAME
是在 Oracle Object Storage Cloud 中具有所需访问权限的用户的 ID。
对于在联合身份提供程序中创建的用户,请指定用户的全限定名称(例如 exampleIdP/jdoe
或 exampleIdP/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
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_NAME
是 EPM 云环境中文件或快照的唯一名称。在复制快照时,请勿指定 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
epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/example_file.txt copied_from_osc.txt