AzureStor (version 2.0.1)

call_azcopy: Call the azcopy file transfer utility

Description

Call the azcopy file transfer utility

Usage

call_azcopy(...)

azcopy_login(force = FALSE)

Arguments

...

Arguments to pass to AzCopy on the commandline. If no arguments are supplied, a help screen is printed.

force

For azcopy_login, whether to force AzCopy to relogin. If FALSE (the default), and AzureStor has detected that AzCopy has already logged in, this has no effect.

Details

AzureStor has the ability to use the Microsoft AzCopy commandline utility to transfer files. To enable this, set the argument use_azcopy=TRUE in any call to an upload or download function; AzureStor will then call AzCopy to perform the file transfer rather than relying on its own code. You can also call AzCopy directly with the call_azcopy function, passing it any arguments as required.

AzureStor requires version 10 or later of AzCopy, which is a substantial rewrite and is currently (as of February 2019) in beta. The first time you try to run it, AzureStor will check that the version of AzCopy is correct, and throw an error if it is version 8 or earlier.

The AzCopy utility must be in your path for AzureStor to find it. Note that unlike earlier versions, Azcopy 10 is a single, self-contained binary file that can be placed in any directory.

AzCopy uses its own mechanisms for authenticating with Azure Active Directory, which is independent of the OAuth tokens used by AzureStor. AzureStor will try to ensure that AzCopy has previously authenticated before trying to transfer a file with a token, but this may not always succeed. You can run azcopy_login(force=TRUE) to force it to authenticate.

See Also

AzCopy page on Microsoft Docs

AzCopy GitHub repo