copyFromObjectStorage

Copie un fichier ou un instantané de sauvegarde d'un bucket Oracle Object Storage vers l'environnement actuel.

Si vous copiez un instantané de sauvegarde, cette commande le copie à partir du bucket Object Storage et en extrait le contenu vers Oracle Enterprise Performance Management Cloud.

Champ d'application

Planning, modules Planning, 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, Strategic Workforce Planning et Sales Planning.

Rôles requis

Administrateur de service

Syntaxe

epmautomate copyFromObjectStorage USERNAME PASSWORD URL TARGET_FILE_NAME, où :

  • USERNAME est l'ID d'un utilisateur qui dispose des droits d'accès requis dans Oracle Object Storage Cloud.

    Pour les utilisateurs créés dans un fournisseur d'identités fédérées, indiquez le nom qualifié complet de l'utilisateur (par exemple, exampleIdP/jdoe ou exampleIdP/john.doe@example.com, où exampleIdP est le nom du fournisseur d'identités fédérées). Pour les autres utilisateurs, fournissez l'ID utilisateur.

  • PASSWORD est le mot de passe Swift ou le jeton d'authentification associé à l'utilisateur. Ce mot de passe est différent de celui que vous utilisez pour vous connecter à la console Object Storage. Le jeton d'authentification est un jeton généré par Oracle que vous utilisez pour l'authentification auprès d'API tierces, par exemple auprès d'un client Swift. Afin d'obtenir des instructions pour créer ce jeton, reportez-vous à la section Procédure de création d'un jeton d'authentification du guide Documentation Oracle Cloud Infrastructure .
  • URL est l'URL du bucket Oracle Object Storage Cloud comprenant le nom de bucket et le nom de l'objet à copier.

    Format d'URL :

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

    Composants de cet URL :
    • region_identifier est une région d'hébergement Oracle Cloud Infrastructure.
    • namespace est le conteneur de niveau supérieur pour tous les buckets et les objets. Un nom unique d'espace de noms Object Storage généré par le système et immuable est affecté à chaque locataire Oracle Cloud Infrastructure au moment de la création de compte. Le nom d'espace de noms de votre locataire, par exemple, axaxnpcrorw5, est effectif dans toutes les régions.
    • bucket_name est le nom du conteneur logique dans lequel vous stockez vos données et vos fichiers. Les buckets sont organisés et tenus à jour dans des compartiments. Un nom de bucket généré par le système, par exemple, bucket-20210301-1359 reflète l'année, le mois, le jour et l'heure en cours.
    • object_name est le nom de l'instantané ou du fichier que vous voulez copier à partir d'Oracle Object Storage Cloud. Cette valeur doit correspondre exactement au nom complet de l'objet dans Object Storage Cloud. N'utilisez pas d'extension telle que .zip, sauf si elle figure dans le nom de l'objet.

    Pour plus d'informations, reportez-vous à ces rubriques dans la documentation Oracle Cloud Infrastructure

  • TARGET_FILE_NAME est le nom unique du fichier ou de l'instantané dans l'environnement EPM Cloud. Lors de la copie d'instantanés, n'indiquez pas l'extension ZIP afin que le nom de fichier puisse être utilisé avec la commande importSnapshot.

    Les fichiers dont la taille est supérieure à 100 Mo sont stockés dans Oracle Object Storage au sein d'un répertoire logique avec le fichier manifeste qui identifie les segments. Indiquez le nom du répertoire logique au format TARGET_FILE_NAME.

Exemples

Dans ces exemples, remplacez URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET par une URL fonctionnelle au format suivant : https://swiftobjectstorage.identificateur_région.oraclecloud.com/v1/espacedenoms/nom_bucket/.

  • Copie d'un instantané nommé backup_Snapshot_12_05_20.zip d'un bucket Oracle Object Storage vers EPM Cloud et changement de son nom :

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

  • Copie d'un instantané nommé bbackup_Snapshot_12_05_20 d'un bucket Oracle Object Storage vers EPM Cloud et changement de son nom :

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_Snapshot_12_05_20 snapshot_from_osc

  • Copie d'un instantané nommé bbackup_Snapshot_12_05_20 d'un bucket Oracle Object Storage vers EPM Cloud sans changer son nom :

    epmautomate copyFromObjectStorage oracleidentitycloudservice/jDoe example_pwd URL_OF_THE_ORACLE_OBJECT_STORAGE_BUCKET/backup_snapshot_12_05_20 backup_snapshot_12_05_20

  • Copie d'un fichier vers EPM Cloud à partir d'un bucket Oracle Object Storage :

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