copyToObjectStorage

Kopiert eine Datei oder einen Snapshot aus der aktuellen Umgebung in eine Oracle Object Storage Cloud-Gruppe.

Wenn Sie einen Snapshot kopieren, komprimiert dieser Befehl den Inhalt des Snapshots vor dem Kopieren in Oracle Object Storage.

Damit Sie Dateien schneller kopieren können, teilt dieser Befehl große Dateien (größer als 100 MB) in Segmente von je 10 MB auf (FILE_NAME/FILE_NAME_object_store_bytes_seg_0 bis FILE_NAME/FILE_NAME_object_store_bytes_seg_n) und erstellt eine Manifestdatei (FILE_NAME/FILE_NAME.manifest). Dateisegmente werden gemeinsam mit der Manifestdatei in Oracle Object Storage gespeichert. In der Object Storage-Konsole wird die Datei als logisches Verzeichnis angezeigt, das die Dateisegmente und die Manifestdatei enthält.

Dateien, die kleiner als 100 MB sind, werden nicht in Segmente aufgeteilt und mit dem ursprünglichen Dateinamen gespeichert.

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 copyToObjectStorage SOURCE_FILE_NAME USERNAME PASSWORD URL wobei Folgendes gilt:

  • SOURCE_FILE_NAME ist der Name der Datei oder des Snapshots in der Oracle Enterprise Performance Management Cloud. Geben Sie beim Kopieren eines Snapshots nicht die ZIP-Erweiterung an.
  • USERNAME ist die ID eines Benutzers, der in Oracle Object Storage Cloud über die erforderlichen Zugriffsberechtigungen zum Schreiben 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, der ein optionaler Objektname angehängt wurde.

    Das URL-Format ohne Objektname lautet folgendermaßen:

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

    Das URL-Format mit Objektnamen lautet folgendermaßen:

    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 (optional) ist der Name, den Sie für die Datei in Oracle Object Storage Cloud verwenden können. Wenn kein Objektname angegeben ist, wird die Datei mit ihrem Originalnamen kopiert.

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

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/.

  • So kopieren Sie einen Snapshot in eine Object Storage-Gruppe und benennen ihn um:

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

  • So kopieren Sie eine Datei in eine Object Storage-Gruppe:

    epmautomate copyToObjectStorage example_file.txt oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET

  • So kopieren Sie eine Datei in eine Object Storage-Gruppe und benennen sie um:

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