copyFromObjectStorage

Kopiert eine Datei oder einen Backup-Snapshot aus einer Oracle Object Storage-Gruppe in die aktuelle Umgebung.

Wenn Sie einen Backup-Snapshot kopieren, wird er mit diesem Befehl aus der Object Storage-Gruppe kopiert, und sein Inhalt wird in Oracle Enterprise Performance Management Cloud extrahiert.

Gilt für

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Narrative Reporting, Strategische Personalplanung und Sales Planning.

Erforderliche Rollen

Serviceadministrator

Verwendung

epmautomate copyFromObjectStorage USERNAME PASSWORD URL TARGET_FILE_NAME wobei Folgendes gilt:

  • USERNAME ist die ID eines Benutzers, der in Oracle Object Storage Cloud über die erforderlichen Zugriffsberechtigungen verfügt.

    Bei im föderierten Identitätsprovider erstellten Benutzern geben Sie den vollqualifizierten Namen des Benutzers an (Beispiel: exampleIdP/jdoe oder exampleIdP/john.doe@example.com, wobei exampleIdP der Name des föderierten Identitätsproviders ist). Geben Sie bei anderen Benutzern die Benutzer-ID an.

  • PASSWORD ist das Swift-Kennwort oder das Authentifizierungstoken, das mit dem Benutzer verknüpft ist. Dieses Kennwort stimmt nicht mit dem Kennwort überein, das Sie für die Anmeldung bei der Object Storage-Konsole verwenden. Das Authentifizierungstoken ist ein von Oracle generiertes Token, mit dem Sie Drittanbieter-APIs authentifizieren können, beispielsweise für die Authentifizierung mit einem Swift-Client. Anweisungen zum Erstellen dieses Token finden Sie unter So erstellen Sie ein Authentifizierungstoken: in der Dokumentation Oracle Cloud Infrastructure-Dokumentation .
  • URL ist die URL der Oracle Object Storage Cloud-Gruppe, einschließlich des Gruppennamens und des Namens des zu kopierenden Objekts.

    Das URL-Format:

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

    Komponenten dieser URL:
    • region_identifier ist eine Region für das Hosting von Oracle Cloud Infrastructure.
    • namespace ist der Container der obersten Ebene für alle Gruppen und Objekte. Beim Erstellen des Accounts wird jedem Mandanten von Oracle Cloud Infrastructure ein eindeutiger, vom System generierter und unveränderbarer Object Storage-Namespace-Name zugewiesen. Der Namespace-Name Ihres Mandanten, zum Beispiel axaxnpcrorw5, gilt für alle Regionen.
    • bucket_name ist der Name eines logischen Containers, in dem Sie Ihre Daten und Dateien speichern. Gruppen werden in Compartments organisiert und verwaltet. Ein vom System generierter Gruppenname, zum Beispiel bucket-20210301-1359, enthält das aktuelle Jahr, den Monat, den Tag und die Uhrzeit.
    • object_name ist der Name des Snapshots oder der Datei, die Sie aus Oracle Object Storage Cloud kopieren möchten. Dieser Wert muss exakt mit dem vollständigen Namen des Objekts in Object Storage Cloud übereinstimmen. Verwenden Sie Erweiterungen wie .zip nur, wenn diese auch im Objektnamen enthalten sind.

    Weitere Informationen finden Sie unter den folgenden Themen in der Oracle Cloud Infrastructure-Dokumentation

  • TARGET_FILE_NAME ist ein eindeutiger Name für die Datei oder den Snapshot in der EPM Cloud-Umgebung. Geben Sie beim Kopieren von Snapshots nicht die ZIP-Erweiterung an, damit dieser Dateiname mit dem Befehl importSnapshot verwendet werden kann.

    Dateien, die größer als 100 MB sind, werden in Oracle Object Storage zusammen mit der Manifestdatei, die die entsprechenden Segmente angibt, in einem logischen Verzeichnis gespeichert. Geben Sie den Namen des logischen Verzeichnisses als TARGET_FILE_NAME an.

Beispiele

Ersetzen Sie in diesen Beispielen URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET mit einer aktiven URL in diesem Format: https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name/.

  • Kopieren Sie einen Snapshot mit der Bezeichnung backup_Snapshot_12_05_20.zip aus einer Oracle Object Storage-Gruppe in EPM Cloud, und benennen Sie ihn um:

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

  • Kopieren Sie einen Snapshot mit der Bezeichnung backup_Snapshot_12_05_20 aus einer Oracle Object Storage-Gruppe in EPM Cloud, und benennen Sie ihn um:

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_Snapshot_12_05_20 snapshot_from_osc

  • Kopieren Sie einen Snapshot mit der Bezeichnung backup_Snapshot_12_05_20 aus einer Oracle Object Storage-Gruppe in EPM Cloud, ohne ihn umzubenennen:

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_snapshot_12_05_20 backup_snapshot_12_05_20

  • So kopieren Sie eine Datei aus einer Oracle Object Storage-Gruppe in EPM Cloud:

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