Skip to contents

Upload files or directories to any registered bucket. Handles small files via put_object and large files via multipart upload automatically.

Usage

cdn_upload(
  bucket,
  key,
  local_path,
  metadata = list(),
  overwrite = FALSE,
  part_size = 100 * 1024^2
)

cdn_upload_dir(
  bucket,
  prefix,
  local_dir,
  metadata = list(),
  overwrite = FALSE,
  part_size = 100 * 1024^2
)

cdn_create_dir(bucket, prefix)

Arguments

bucket

Character(1). A registered bucket name.

key

Character(1). The destination object key (for single file uploads).

local_path

Character(1). Path to a local file.

metadata

Named list of metadata to attach to each object.

overwrite

Logical(1). Allow overwriting existing keys. Defaults to FALSE.

part_size

Numeric(1). Threshold in bytes for multipart upload. Defaults to 100 MB.

prefix

Character(1). The destination prefix (for directory uploads).

local_dir

Character(1). Path to a local directory.

Value

The S3 key (invisibly).

Character vector of uploaded S3 keys (invisibly).

The placeholder key (invisibly).

Functions

  • cdn_upload(): Upload a single file

  • cdn_upload_dir(): Upload a directory of files

  • cdn_create_dir(): Create a zero-byte directory placeholder

Examples

if (FALSE) { # \dontrun{
cdn_upload("art-data", "processed/uuid/file.png", "/tmp/file.png")
} # }
if (FALSE) { # \dontrun{
cdn_upload_dir("art-data", "processed/uuid/", "/tmp/artwork_files/")
} # }