copyFromObjectStorage

將檔案或備份快照從 Oracle Object Storage 分組複製至目前環境。

如果您要複製備份快照,則此命令會從 Object Storage 時段進行複製,並在 Oracle Enterprise Performance Management Cloud 中擷取其內容。

適用於

PlanningPlanning 模組FreeFormFinancial Consolidation and CloseTax ReportingAccount ReconciliationProfitability and Cost ManagementEnterprise Profitability and Cost ManagementOracle Enterprise Data Management CloudNarrative ReportingStrategic Workforce PlanningSales Planning

必要角色

服務管理員

用法

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 基礎架構主控區域。
    • namespace 是所有分組與物件的頂層容器。每個 Oracle Cloud 基礎架構租用戶都會在帳戶建立時,被指派唯一的系統產生且不可變的 Object Storage 命名空間名稱。您租用戶的命名空間名稱 (例如axaxnpcrorw5) 在所有區域間都有效。
    • bucket_name 是您儲存資料與檔案之邏輯容器的名稱。分組是在區間下組織並維護。系統產生的分組名稱 (例如 bucket-20210301-1359) 會反映目前年度、月份、日期及時間。
    • object_name 是您要從 Oracle Object Storage Cloud 中複製之快照或檔案的名稱。此值必須與 Object Storage Cloud 中物件的全整名稱完全相符。請勿使用像 .zip 此類的副檔名,除非其已包含在物件名稱中。

    如需詳細資訊,請參閱 Oracle Cloud 基礎架構文件中的下列主題

  • TARGET_FILE_NAMEEPM Cloud 環境中檔案或快照的唯一名稱。複製快照時,請勿指定 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 Cloud 並重新命名:

    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 Cloud 並重新命名:

    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 Cloud 而且不重新命名:

    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 Cloud

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