getObjectTorrent

abstract suspend fun <T> getObjectTorrent(input: GetObjectTorrentRequest, block: suspend (GetObjectTorrentResponse) -> T): T

This operation is not supported for directory buckets.

Returns torrent files from a bucket. BitTorrent can save you bandwidth when you're distributing large files.

You can get torrent only for objects that are less than 5 GB in size, and that are not encrypted using server-side encryption with a customer-provided encryption key.

To use GET, you must have READ access to the object.

This functionality is not supported for Amazon S3 on Outposts.

The following action is related to GetObjectTorrent:

You must URL encode any signed header values that contain spaces. For example, if your header value is my file.txt, containing two spaces after my, you must URL encode this value to my%20%20file.txt.

Samples


fun main() { 
   //sampleStart 
   // The following example retrieves torrent files of an object.
val resp = s3Client.getObjectTorrent {
    bucket = "examplebucket"
    key = "HappyFace.jpg"
} 
   //sampleEnd
}