All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.s3.model.BucketVersioningConfiguration Maven / Gradle / Ivy

Go to download

The AWS Java Mobile SDK for Amazon S3 module holds the client classes that are used for communicating with Amazon Simple Storage Service

There is a newer version: 2.6.19
Show newest version
/*
 * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 *
 *  http://aws.amazon.com/apache2.0
 *
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

package com.amazonaws.services.s3.model;

import com.amazonaws.services.s3.AmazonS3;

import java.io.Serializable;

/**
 * Represents the versioning configuration for a bucket.
 * 

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

    *
  • {@link BucketVersioningConfiguration#OFF}
  • *
  • {@link BucketVersioningConfiguration#ENABLED}
  • *
  • {@link BucketVersioningConfiguration#SUSPENDED}
  • *
*

*

* By default, new buckets are in the {@link BucketVersioningConfiguration#OFF * off} state. Once versioning is enabled for a bucket the status can never be * reverted to {@link BucketVersioningConfiguration#OFF off}. *

*

* In addition to enabling versioning, a bucket's versioning configuration can * also enable Multi-Factor Authentication (MFA) Delete, which restricts the * ability to permanently delete a version of an object. When MFA Delete is * enabled, only requests from the bucket owner which include an MFA token * generated by the hardware authentication device associated with the bucket * owner's AWS account can permanently delete an object version. For more * information on AWS Multi-Factor Authentication see http://aws.amazon.com/mfa/ *

*

* 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. *

* S3 is eventually consistent. It may take time for the versioning status of a * bucket to be propagated throughout the system. * * @see AmazonS3#getBucketVersioningConfiguration(String) * @see AmazonS3#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) */ public class BucketVersioningConfiguration implements Serializable { /** * S3 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. */ public static final String OFF = "Off"; /** * S3 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. */ public static final String SUSPENDED = "Suspended"; /** * S3 bucket versioning status indicating that versioning is enabled for a * bucket. */ public static final String ENABLED = "Enabled"; /** The current status of versioning */ private String status; /** * Indicates if the optional Multi-Factor Authentication Delete control is * enabled for this bucket versioning configuration. */ private Boolean isMfaDeleteEnabled = null; /** * Creates a new bucket versioning configuration object which defaults to * {@link #OFF} status. */ public BucketVersioningConfiguration() { setStatus(OFF); } /** * 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 {@link #SUSPENDED suspended} and can never be set back to * {@link #OFF off}. * * @param status The desired bucket versioning status for the new * configuration object. * @see #ENABLED * @see #SUSPENDED */ public BucketVersioningConfiguration(String status) { setStatus(status); } /** * Returns the current status of versioning for this bucket versioning * configuration object, indicating if versioning is enabled or not for a * bucket. * * @return The current status of versioning for this bucket versioning * configuration. * @see #OFF * @see #ENABLED * @see #SUSPENDED */ public String getStatus() { return 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 {@link #SUSPENDED suspended} and can never be set back to * {@link #OFF off}. * * @param status The desired status of versioning for this bucket versioning * configuration. * @see #ENABLED * @see #SUSPENDED */ public void setStatus(String status) { this.status = 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 {@link #SUSPENDED suspended} and can never be set back to * {@link #OFF off}. * * @param status The desired status of versioning for this bucket versioning * configuration. * @return The updated S3BucketVersioningConfiguration object so that * additional method calls may be chained together. * @see #ENABLED * @see #SUSPENDED */ public BucketVersioningConfiguration withStatus(String status) { setStatus(status); return this; } /** * Returns true if Multi-Factor Authentication (MFA) Delete is enabled for * this bucket versioning configuration, false if it isn't enabled, and null * if no information is available about the status of MFADelete. *

* When MFA Delete is enabled, object versions can only be permanently * deleted when the bucket owner passes in, as part of a delete version * request, an MFA token from the hardware token generator associated with * their AWS account. *

* By default, MFA Delete is not enabled. *

* When enabling or disabling MFA Delete controls, you must also * supply an MFA token from the hardware token generator. * * @return True if the Multi-Factor Authentication (MFA) Delete is enabled * for this bucket versioning configuration, false if it isn't * enabled, and null if no information is present on the status of * MFA Delete. */ public Boolean isMfaDeleteEnabled() { return isMfaDeleteEnabled; } /** * Sets the status of Multi-Factor Authentication (MFA) Delete for a bucket. * When MFA Delete is enabled, object versions can only be permanently * deleted when the bucket owner passes in, as part of a delete version * request, an MFA token from the hardware token generator associated with * their AWS account. *

* By default, MFA Delete is not enabled. *

* When enabling or disabling MFA Delete controls, you must also * supply an MFA token from the hardware token generator as part of the * request. * * @param mfaDeleteEnabled True if the Multi-Factor Authentication (MFA) * Delete is being enabled enabled, false if it is being * disabled. */ public void setMfaDeleteEnabled(Boolean mfaDeleteEnabled) { isMfaDeleteEnabled = mfaDeleteEnabled; } /** * Sets the status of Multi-Factor Authentication (MFA) Delete for a bucket, * and returns this object so that additional method calls may be chained * together. When MFA Delete is enabled, object versions can only be * permanently deleted when the bucket owner passes in, as part of a delete * version request, an MFA token from the hardware token generator * associated with their AWS account. *

* By default, MFA Delete is not enabled. *

* When enabling or disabling MFA Delete controls, you must also * supply an MFA token from the hardware token generator as part of the * request. * * @param mfaDeleteEnabled True if the Multi-Factor Authentication (MFA) * Delete is being enabled enabled, false if it is being * disabled. * @return The updated S3BucketVersioningConfiguration object so that * additional method calls may be chained together. */ public BucketVersioningConfiguration withMfaDeleteEnabled(Boolean mfaDeleteEnabled) { setMfaDeleteEnabled(mfaDeleteEnabled); return this; } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy