put

abstract fun put(path: String, stream: InputStream): S3Object

Creates or overwrites an object at the specified path with its contents uploaded from the given stream.

Return

An S3Object instance handle on the target object.

Parameters

path

Path to the new object to create.

stream

Stream whose contents will be written to the object in the store at the given path.

Throws

If this bucket or the bucket in which this object container resides no longer exists.

If an implementation specific exception is thrown. The implementation specific exception will be set to the thrown exception's 'cause' value.


abstract fun put(path: String, action: StreamingObjectPutParams.() -> Unit): S3Object

Creates or overwrites an object at the configured path with its contents uploaded from the configured stream.

Return

An S3Object instance handle on the target object.

Parameters

action

Action used to configure the backing S3 operation.

Throws

If the stream value is not set on the configured parameters.

If this bucket or the bucket in which this object container resides no longer exists.

If an implementation specific exception is thrown. The implementation specific exception will be set to the thrown exception's 'cause' value.


abstract fun put(path: String, params: StreamingObjectPutParams): S3Object

Creates or overwrites an object at the configured path with its contents uploaded from the configured stream.

Return

An S3Object instance handle on the target object.

Parameters

params

Parameters for the backing S3 operation.

Throws

If the stream value is not set on the configured parameters.

If this bucket or the bucket in which this object container resides no longer exists.

If an implementation specific exception is thrown. The implementation specific exception will be set to the thrown exception's 'cause' value.