generics function

Storage client generics

Storage client generics

storage_container(endpoint, ...) ## S3 method for class 'blob_endpoint' storage_container(endpoint, name, ...) ## S3 method for class 'file_endpoint' storage_container(endpoint, name, ...) ## S3 method for class 'adls_endpoint' storage_container(endpoint, name, ...) ## S3 method for class 'character' storage_container(endpoint, key = NULL, token = NULL, sas = NULL, ...) create_storage_container(endpoint, ...) ## S3 method for class 'blob_endpoint' create_storage_container(endpoint, name, ...) ## S3 method for class 'file_endpoint' create_storage_container(endpoint, name, ...) ## S3 method for class 'adls_endpoint' create_storage_container(endpoint, name, ...) ## S3 method for class 'storage_container' create_storage_container(endpoint, ...) ## S3 method for class 'character' create_storage_container(endpoint, key = NULL, token = NULL, sas = NULL, ...) delete_storage_container(endpoint, ...) ## S3 method for class 'blob_endpoint' delete_storage_container(endpoint, name, ...) ## S3 method for class 'file_endpoint' delete_storage_container(endpoint, name, ...) ## S3 method for class 'adls_endpoint' delete_storage_container(endpoint, name, ...) ## S3 method for class 'storage_container' delete_storage_container(endpoint, ...) ## S3 method for class 'character' delete_storage_container(endpoint, key = NULL, token = NULL, sas = NULL, confirm = TRUE, ...) list_storage_containers(endpoint, ...) ## S3 method for class 'blob_endpoint' list_storage_containers(endpoint, ...) ## S3 method for class 'file_endpoint' list_storage_containers(endpoint, ...) ## S3 method for class 'adls_endpoint' list_storage_containers(endpoint, ...) ## S3 method for class 'character' list_storage_containers(endpoint, key = NULL, token = NULL, sas = NULL, ...) list_storage_files(container, ...) ## S3 method for class 'blob_container' list_storage_files(container, ...) ## S3 method for class 'file_share' list_storage_files(container, ...) ## S3 method for class 'adls_filesystem' list_storage_files(container, ...) create_storage_dir(container, ...) ## S3 method for class 'blob_container' create_storage_dir(container, dir, ...) ## S3 method for class 'file_share' create_storage_dir(container, dir, ...) ## S3 method for class 'adls_filesystem' create_storage_dir(container, dir, ...) delete_storage_dir(container, ...) ## S3 method for class 'blob_container' delete_storage_dir(container, dir, ...) ## S3 method for class 'file_share' delete_storage_dir(container, dir, ...) ## S3 method for class 'adls_filesystem' delete_storage_dir(container, dir, confirm = TRUE, ...) delete_storage_file(container, ...) ## S3 method for class 'blob_container' delete_storage_file(container, file, ...) ## S3 method for class 'file_share' delete_storage_file(container, file, ...) ## S3 method for class 'adls_filesystem' delete_storage_file(container, file, confirm = TRUE, ...) storage_file_exists(container, file, ...) ## S3 method for class 'blob_container' storage_file_exists(container, file, ...) ## S3 method for class 'file_share' storage_file_exists(container, file, ...) ## S3 method for class 'adls_filesystem' storage_file_exists(container, file, ...) storage_dir_exists(container, dir, ...) ## S3 method for class 'blob_container' storage_dir_exists(container, dir, ...) ## S3 method for class 'file_share' storage_dir_exists(container, dir, ...) ## S3 method for class 'adls_filesystem' storage_dir_exists(container, dir, ...) create_storage_snapshot(container, file, ...) ## S3 method for class 'blob_container' create_storage_snapshot(container, file, ...) list_storage_snapshots(container, ...) ## S3 method for class 'blob_container' list_storage_snapshots(container, ...) delete_storage_snapshot(container, file, ...) ## S3 method for class 'blob_container' delete_storage_snapshot(container, file, ...) list_storage_versions(container, ...) ## S3 method for class 'blob_container' list_storage_versions(container, ...) delete_storage_version(container, file, ...) ## S3 method for class 'blob_container' delete_storage_version(container, file, ...)

Arguments

  • endpoint: A storage endpoint object, or for the character methods, a string giving the full URL to the container.
  • ...: Further arguments to pass to lower-level functions.
  • name: For the storage container management methods, a container name.
  • key, token, sas: For the character methods, authentication credentials for the container: either an access key, an Azure Active Directory (AAD) token, or a SAS. If multiple arguments are supplied, a key takes priority over a token, which takes priority over a SAS.
  • confirm: For the deletion methods, whether to ask for confirmation first.
  • container: A storage container object.
  • file, dir: For the storage object management methods, a file or directory name.

Details

These methods provide a framework for all storage management tasks supported by AzureStor. They dispatch to the appropriate functions for each type of storage.

Storage container management methods:

  • storage_container dispatches to blob_container, file_share or adls_filesystem
  • create_storage_container dispatches to create_blob_container, create_file_share or create_adls_filesystem
  • delete_storage_container dispatches to delete_blob_container, delete_file_share or delete_adls_filesystem
  • list_storage_containers dispatches to list_blob_containers, list_file_shares or list_adls_filesystems

Storage object management methods:

  • list_storage_files dispatches to list_blobs, list_azure_files or list_adls_files
  • create_storage_dir dispatches to create_blob_dir, create_azure_dir or create_adls_dir
  • delete_storage_dir dispatches to delete_blob_dir, delete_azure_dir or delete_adls_dir
  • delete_storage_file dispatches to delete_blob, delete_azure_file or delete_adls_file
  • storage_file_exists dispatches to blob_exists, azure_file_exists or adls_file_exists
  • storage_dir_exists dispatches to blob_dir_exists, azure_dir_exists or adls_dir_exists
  • create_storage_snapshot dispatches to create_blob_snapshot
  • list_storage_snapshots dispatches to list_blob_snapshots
  • delete_storage_snapshot dispatches to delete_blob_snapshot
  • list_storage_versions dispatches to list_blob_versions
  • delete_storage_version dispatches to delete_blob_version

Examples

## Not run: # storage endpoints for the one account bl <- storage_endpoint("https://mystorage.blob.core.windows.net/", key="access_key") fl <- storage_endpoint("https://mystorage.file.core.windows.net/", key="access_key") list_storage_containers(bl) list_storage_containers(fl) # creating containers cont <- create_storage_container(bl, "newblobcontainer") fs <- create_storage_container(fl, "newfileshare") # creating directories (if possible) create_storage_dir(cont, "newdir") # will error out create_storage_dir(fs, "newdir") # transfer a file storage_upload(bl, "~/file.txt", "storage_file.txt") storage_upload(cont, "~/file.txt", "newdir/storage_file.txt") ## End(Not run)

See Also

storage_endpoint , blob_container , file_share , adls_filesystem

list_blobs , list_azure_files , list_adls_files

Similar generics exist for file transfer methods; see the page for storage_download .

  • Maintainer: Hong Ooi
  • License: MIT + file LICENSE
  • Last published: 2022-05-25