copyFromSFTP

Kopiert eine Datei direkt von einem sicheren SFTP-Server in eine Oracle Fusion Cloud Enterprise Performance Management-Umgebung.

Mit diesem Befehl können Sie eine Datei direkt von einem SFTP-Server kopieren, ohne sie zunächst mit einem SFTP-Client auf einen anderen Server herunterladen und sie dann mit EPM Automate oder der REST-API in Cloud EPM hochladen zu müssen.

Wenn eine IP-Ausnahmeliste für den SFTP-Server aktiviert ist, müssen Sie die ausgehende IP-Adresse der OCI-Region, in der die Cloud EPM-Umgebungen gehostet werden, zur IP-Ausnahmeliste des SFTP-Servers hinzufügen. Die ausgehenden IP-Adressen von OCI-Regionen finden Sie unter Ausgehende IP-Adressen von Cloud EPM-Data-Centern und -Regionen in der Dokumentation zu Vorgängen.

Note:

Dieser Befehl unterstützt nur SFTP-Server, die auf Port 22 ausgeführt werden. Dieser Befehl unterstützt diese Ciphers, MACs, Schlüsselaustauschalgorithmen und Host-Key-Algorithmen. Der SFTP-Server muss in jeder erforderlichen Kategorie mindestens einen dieser kryptografischen Algorithmen unterstützen.

Table 2-2 Unterstützte kryptografische Algorithmen

Kryptografischer Algorithmustyp Unterstützte Algorithmen
Ciphers 
chacha20-poly1305@openssh.com, aes128-ctr, aes192-ctr, 
aes256-ctr, aes128-gcm@openssh.com, aes256-gcm@openssh.com, 
aes128-cbc,aes192-cbc, aes256-cbc
MACs 
hmac-sha2-256-etm@openssh.com, hmac-sha2-512-etm@openssh.com, 
hmac-sha1-etm@openssh.com, hmac-sha2-256, hmac-sha2-512, hmac-sha1
Schlüsselaustauschalgorithmen 
sntrup761x25519-sha512, sntrup761x25519-sha512@openssh.com, 
curve25519-sha256, curve25519-sha256@libssh.org, curve448-sha512, 
ecdh-sha2-nistp521, ecdh-sha2-nistp384, ecdh-sha2-nistp256, 
diffie-hellman-group-exchange-sha256, diffie-hellman-group18-sha512, 
diffie-hellman-group17-sha512, diffie-hellman-group16-sha512, 
diffie-hellman-group15-sha512, diffie-hellman-group14-sha256
Host-Key-Algorithmen 
ecdsa-sha2-nistp256-cert-v01@openssh.com, 
ecdsa-sha2-nistp384-cert-v01@openssh.com, 
ecdsa-sha2-nistp521-cert-v01@openssh.com, 
ssh-ed25519-cert-v01@openssh.com, rsa-sha2-512-cert-v01@openssh.com, 
rsa-sha2-256-cert-v01@openssh.com, ecdsa-sha2-nistp256, 
ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, ssh-ed25519, 
sk-ecdsa-sha2-nistp256@openssh.com, sk-ssh-ed25519@openssh.com, 
rsa-sha2-512,rsa-sha2-256, ssh-rsa

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
  • Alle Anwendungsrollen und die granulare Rolle "Migrationen - Verwalten"

Verwendung

epmautomate copyFromSftp SFTP_SERVER_URL FILE_NAME username=USERNAME [password=PASSWORD] [privateKey=KEY_FILE] [passPhrase=PASSPHRASE], wobei Folgendes gilt:

  • SFTP_SERVER_URL ist die URL des SFTP-Servers einschließlich des Speicherorts und des Namens der Datei, die Sie vom Server kopieren möchten.
  • FILE_NAME ist der Dateiname für die Datei in der Cloud EPM-Umgebung. Geben Sie beispielsweise den Pfad an, wenn Sie die Datei nicht an den Standardspeicherort zum Hochladen kopieren möchten.
  • USERNAME ist die ID eines Benutzers, der die erforderlichen Zugriffsrechte auf dem SFTP-Server hat.
  • PASSWORD (optional) ist das SFTP-Benutzerkennwort. Erforderlich, wenn Sie keinen Private Key für den Zugriff auf den SFTP-Server verwenden.
  • KEY_FILE (optional) ist der Name und der Pfad der Private-Key-(PEM-)Datei, die auf Ihrem Computer gespeichert ist. Erforderlich, wenn Sie kein Nur-Text-Kennwort zur Authentifizierung des Benutzers verwenden.
  • PASSPHRASE (optional) ist die Passphrase, die zum Schutz des Verschlüsselungsschlüssels verwendet wird. Nur erforderlich, wenn eine Passphrase zur Verschlüsselung des Private Key verwendet wird.

Beispiele

  • Benutzernamen und Nur-Text-Kennwort verwenden:

    epmautomate copyFromSftp sftp://mySFTP_Server/someDirectory/someFile.csv myFile.csv username=jdoe password=Sftpwelcome

  • Benutzernamen und ungeschützten Private Key zur Authentifizierung verwenden:

    epmautomate copyFromSftp sftp://mySFTP_Server/someDirectory/someFile.csv myFile.csv username=jdoe privateKey= ~/.oci/sftp_key.pem

  • Benutzernamen und durch eine Passphrase geschützten Private Key zur Authentifizierung verwenden:

    epmautomate copyFromSftp sftp://mySFTP_Server/someDirectory/some_file.csv myFile.csv username=jDoe privateKey=~/.oci/sftp_key.pem passphrase=myPassPhrase