copyToObjectStorage

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

如果您正在复制快照，则此命令会先压缩快照内容，然后再将其复制到 Oracle Object Storage。

为了支持快速复制文件，此命令将大文件（超过 100 MB）分成多个 10 MB 的段（命名为 FILE_NAME/FILE_NAME_object_store_bytes_seg_0 至 FILE_NAME/FILE_NAME_object_store_bytes_seg_n）并创建清单文件（命名为 FILE_NAME/FILE_NAME.manifest）。文件段与清单文件一起存储在 Oracle Object Storage 中。在对象存储控制台中，文件显示为包含文件段和清单文件的逻辑目录。

小于 100 MB 的文件不分段，并以原始文件名存储。

适用于

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 copyToObjectStorage SOURCE_FILE_NAME USERNAME PASSWORD URL，其中：

  • SOURCE_FILE_NAME 是 Oracle Enterprise Performance Management Cloud 中文件或快照的名称。如果您正在复制快照，则不要指定 ZIP 扩展名。
  • 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

    包含对象名称的 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 上文件的名称。如果未指定对象名称，则将使用文件的原始名称复制该文件。

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

示例

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

  • 将快照复制到对象存储的存储桶并对其进行重命名：

    epmautomate copyToObjectStorage "Artifact Snapshot" oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/Snapshot_04_30_21

  • 将文件复制到对象存储的存储桶：

    epmautomate copyToObjectStorage example_file.txt oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET

  • 将文件复制到对象存储的存储桶并对其进行重命名：

    epmautomate copyToObjectStorage example_file.txt eoracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/epm_text_file.txt