stat

abstract fun stat(path: String): ObjectMeta?

Fetches metadata for the object at the target path.

If the target object does not exist, null will be returned.

Return

An ObjectMeta instance containing the target object's metadata if the target object exists, otherwise null.

Parameters

path

Path to the target object whose metadata should be returned.

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 stat(path: String, action: ObjectStatParams.() -> Unit): ObjectMeta?

Fetches metadata for the object at the target path.

If the target object does not exist, null will be returned.

Return

An ObjectMeta instance containing the target object's metadata if the target object exists, otherwise null.

Parameters

path

Path to the target object whose metadata should be returned.

action

Action used to configure the backing S3 operation.

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 stat(path: String, params: ObjectStatParams): ObjectMeta?

Fetches metadata for the object at the target path.

If the target object does not exist, null will be returned.

Return

An ObjectMeta instance containing the target object's metadata if the target object exists, otherwise null.

Parameters

path

Path to the target object whose metadata should be returned.

params

Parameters for the backing S3 operation.

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.