com.aliyun.oss.model

Class BucketVersioningConfiguration

java.lang.Object

com.aliyun.oss.model.BucketVersioningConfiguration

All Implemented Interfaces:

Serializable

public class BucketVersioningConfiguration
extends Object
implements Serializable

Represents the versioning configuration for a bucket.

A bucket's versioning configuration can be in one of three possible states:

• OFF
• ENABLED
• SUSPENDED

By default, new buckets are in the off state. Once versioning is enabled for a bucket the status can never be reverted to off.

The versioning configuration of a bucket has different implications for each operation performed on that bucket or for objects within that bucket. For instance, when versioning is enabled, a PutObject operation creates a unique object version-id for the object being uploaded. The PutObject API guarantees that, if versioning is enabled for a bucket at the time of the request, the new object can only be permanently deleted using the DeleteVersion operation. It can never be overwritten. Additionally, PutObject guarantees that, if versioning is enabled for a bucket the request, no other object will be overwritten by that request. Refer to the documentation sections for each API for information on how versioning status affects the semantics of that particular API.

OSS is eventually consistent. It may take time for the versioning status of a bucket to be propagated throughout the system.

See Also:

OSS.getBucketVersioning(String), OSS.setBucketVersioning(SetBucketVersioningRequest), Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	ENABLED OSS bucket versioning status indicating that versioning is enabled for a bucket.
static String	OFF OSS bucket versioning status indicating that versioning is off for a bucket.
static String	SUSPENDED OSS bucket versioning status indicating that versioning is suspended for a bucket.

Constructor Summary

Constructors

Constructor and Description
BucketVersioningConfiguration() Creates a new bucket versioning configuration object which defaults to OFF status.
BucketVersioningConfiguration(String status) Creates a new bucket versioning configuration object with the specified status.

Method Summary

Methods

Modifier and Type	Method and Description
String	getStatus() Returns the current status of versioning for this bucket versioning configuration object, indicating if versioning is enabled or not for a bucket.
void	setStatus(String status) Sets the desired status of versioning for this bucket versioning configuration object.
BucketVersioningConfiguration	withStatus(String status) Sets the desired status of versioning for this bucket versioning configuration object, and returns this object so that additional method calls may be chained together.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OFF

public static final String OFF

OSS bucket versioning status indicating that versioning is off for a bucket. By default, all buckets start off with versioning off. Once you enable versioning for a bucket, you can never set the status back to "Off". You can only suspend versioning on a bucket once you've enabled.

See Also:

Constant Field Values

SUSPENDED

public static final String SUSPENDED

OSS bucket versioning status indicating that versioning is suspended for a bucket. Use the "Suspended" status when you want to disable versioning on a bucket that has versioning enabled.

See Also:

Constant Field Values

ENABLED

public static final String ENABLED

OSS bucket versioning status indicating that versioning is enabled for a bucket.

See Also:

Constant Field Values

Constructor Detail

BucketVersioningConfiguration

public BucketVersioningConfiguration()

Creates a new bucket versioning configuration object which defaults to OFF status.

BucketVersioningConfiguration

public BucketVersioningConfiguration(String status)

Creates a new bucket versioning configuration object with the specified status.

Note that once versioning has been enabled for a bucket, its status can only be suspended and can never be set back to off.

Parameters:

status - The desired bucket versioning status for the new configuration object.

See Also:

ENABLED, SUSPENDED

Method Detail

getStatus

public String getStatus()

Returns the current status of versioning for this bucket versioning configuration object, indicating if versioning is enabled or not for a bucket.

Returns:

The current status of versioning for this bucket versioning configuration.

See Also:

OFF, ENABLED, SUSPENDED

setStatus

public void setStatus(String status)

Sets the desired status of versioning for this bucket versioning configuration object.

Note that once versioning has been enabled for a bucket, its status can only be suspended and can never be set back to off.

Parameters:

status - The desired status of versioning for this bucket versioning configuration.

See Also:

ENABLED, SUSPENDED

withStatus

public BucketVersioningConfiguration withStatus(String status)

Sets the desired status of versioning for this bucket versioning configuration object, and returns this object so that additional method calls may be chained together.

Note that once versioning has been enabled for a bucket, its status can only be suspended and can never be set back to off.

Parameters:

status - The desired status of versioning for this bucket versioning configuration.

Returns:

The updated OSS BucketVersioningConfiguration object so that additional method calls may be chained together.

See Also:

ENABLED, SUSPENDED