public static interface MultipartConfiguration.Builder extends CopyableBuilder<MultipartConfiguration.Builder,MultipartConfiguration>
MultipartConfiguration
.Modifier and Type | Method and Description |
---|---|
Long |
apiCallBufferSizeInBytes()
Indicates the value of the maximum memory usage that the SDK will use.
|
MultipartConfiguration.Builder |
apiCallBufferSizeInBytes(Long apiCallBufferSizeInBytes)
Configures the maximum amount of memory, in bytes, the SDK will use to buffer content of requests in memory.
|
Long |
minimumPartSizeInBytes()
Indicated the value of the part configured size.
|
MultipartConfiguration.Builder |
minimumPartSizeInBytes(Long minimumPartSizeInBytes)
Configures the part size, in bytes, to be used in each individual part requests.
|
Long |
thresholdInBytes()
Indicates the value of the configured threshold.
|
MultipartConfiguration.Builder |
thresholdInBytes(Long thresholdInBytes)
Configure the size threshold, in bytes, for when to use multipart upload.
|
copy
applyMutation, build
MultipartConfiguration.Builder thresholdInBytes(Long thresholdInBytes)
Multipart uploads are easier to recover from and also potentially faster than single part uploads, especially when the upload parts can be uploaded in parallel. Because there are additional network API calls, small objects are still recommended to use a single connection for the upload. See Uploading and copying objects using multipart upload.
By default, it is the same as minimumPartSizeInBytes(Long)
.
thresholdInBytes
- the value of the threshold to set.Long thresholdInBytes()
MultipartConfiguration.Builder minimumPartSizeInBytes(Long minimumPartSizeInBytes)
When uploading large payload, the size of the payload of each individual part requests might actually be bigger than the configured value since there is a limit to the maximum number of parts possible per multipart request. If the configured part size would lead to a number of parts higher than the maximum allowed, a larger part size will be calculated instead to allow fewer part to be uploaded, to avoid the limit imposed on the maximum number of parts.
In the case where the minimumPartSizeInBytes
is set to a value higher than the thresholdInBytes
, when
the client receive a request with a size smaller than a single part multipart operation will NOT be performed
even if the size of the request is larger than the threshold.
Default value: 8 Mib
minimumPartSizeInBytes
- the value of the part size to setLong minimumPartSizeInBytes()
MultipartConfiguration.Builder apiCallBufferSizeInBytes(Long apiCallBufferSizeInBytes)
Default value: If not specified, the SDK will use the equivalent of four parts worth of memory, so 32 Mib by default.
apiCallBufferSizeInBytes
- the value of the maximum memory usage.Long apiCallBufferSizeInBytes()
Copyright © 2023. All rights reserved.