Class StorageClass

Storage class to move an object to.

Inheritance
object
StorageClass
Namespace: Amazon.CDK.AWS.S3
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class StorageClass : DeputyBase
Syntax (vb)
Public Class StorageClass Inherits DeputyBase
Remarks

ExampleMetadata: infused

Examples
var bucket = new Bucket(this, "MyBucket", new BucketProps {
                LifecycleRules = new [] { new LifecycleRule {
                    AbortIncompleteMultipartUploadAfter = Duration.Minutes(30),
                    Enabled = false,
                    Expiration = Duration.Days(30),
                    ExpirationDate = new Date(),
                    ExpiredObjectDeleteMarker = false,
                    Id = "id",
                    NoncurrentVersionExpiration = Duration.Days(30),

                    // the properties below are optional
                    NoncurrentVersionsToRetain = 123,
                    NoncurrentVersionTransitions = new [] { new NoncurrentVersionTransition {
                        StorageClass = StorageClass.GLACIER,
                        TransitionAfter = Duration.Days(30),

                        // the properties below are optional
                        NoncurrentVersionsToRetain = 123
                    } },
                    ObjectSizeGreaterThan = 500,
                    Prefix = "prefix",
                    ObjectSizeLessThan = 10000,
                    Transitions = new [] { new Transition {
                        StorageClass = StorageClass.GLACIER,

                        // exactly one of transitionAfter or transitionDate must be specified
                        TransitionAfter = Duration.Days(30)
                    } }
                } }
            });

Synopsis

Constructors

StorageClass(string)

Storage class to move an object to.

Properties

DEEP_ARCHIVE

Use for archiving data that rarely needs to be accessed.
GLACIER

Storage class for long-term archival that can take between minutes and hours to access.
GLACIER_INSTANT_RETRIEVAL

Storage class for long-term archival that can be accessed in a few milliseconds.
INFREQUENT_ACCESS

Storage class for data that is accessed less frequently, but requires rapid access when needed.
INTELLIGENT_TIERING

The INTELLIGENT_TIERING storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead.
ONE_ZONE_INFREQUENT_ACCESS

Infrequent Access that's only stored in one availability zone.
Value

Storage class to move an object to.

Methods

ToString()

Storage class to move an object to.

Constructors

StorageClass(string)

Storage class to move an object to.

public StorageClass(string value)
Parameters
value string
Remarks

ExampleMetadata: infused

Examples
var bucket = new Bucket(this, "MyBucket", new BucketProps {
                LifecycleRules = new [] { new LifecycleRule {
                    AbortIncompleteMultipartUploadAfter = Duration.Minutes(30),
                    Enabled = false,
                    Expiration = Duration.Days(30),
                    ExpirationDate = new Date(),
                    ExpiredObjectDeleteMarker = false,
                    Id = "id",
                    NoncurrentVersionExpiration = Duration.Days(30),

                    // the properties below are optional
                    NoncurrentVersionsToRetain = 123,
                    NoncurrentVersionTransitions = new [] { new NoncurrentVersionTransition {
                        StorageClass = StorageClass.GLACIER,
                        TransitionAfter = Duration.Days(30),

                        // the properties below are optional
                        NoncurrentVersionsToRetain = 123
                    } },
                    ObjectSizeGreaterThan = 500,
                    Prefix = "prefix",
                    ObjectSizeLessThan = 10000,
                    Transitions = new [] { new Transition {
                        StorageClass = StorageClass.GLACIER,

                        // exactly one of transitionAfter or transitionDate must be specified
                        TransitionAfter = Duration.Days(30)
                    } }
                } }
            });

Properties

DEEP_ARCHIVE

Use for archiving data that rarely needs to be accessed.

public static StorageClass DEEP_ARCHIVE { get; }
Property Value

StorageClass

Remarks

Data stored in the DEEP_ARCHIVE storage class has a minimum storage duration period of 180 days and a default retrieval time of 12 hours. If you delete an object before the 180-day minimum, you are charged for 180 days. For pricing information, see Amazon S3 Pricing.

GLACIER

Storage class for long-term archival that can take between minutes and hours to access.

public static StorageClass GLACIER { get; }
Property Value

StorageClass

Remarks

Use for archives where portions of the data might need to be retrieved in minutes. Data stored in the GLACIER storage class has a minimum storage duration period of 90 days and can be accessed in as little as 1-5 minutes using expedited retrieval. If you delete an object before the 90-day minimum, you are charged for 90 days.

GLACIER_INSTANT_RETRIEVAL

Storage class for long-term archival that can be accessed in a few milliseconds.

public static StorageClass GLACIER_INSTANT_RETRIEVAL { get; }
Property Value

StorageClass

Remarks

It is ideal for data that is accessed once or twice per quarter, and that requires immediate access. Data stored in the GLACIER_IR storage class has a minimum storage duration period of 90 days and can be accessed in as milliseconds. If you delete an object before the 90-day minimum, you are charged for 90 days.

INFREQUENT_ACCESS

Storage class for data that is accessed less frequently, but requires rapid access when needed.

public static StorageClass INFREQUENT_ACCESS { get; }
Property Value

StorageClass

Remarks

Has lower availability than Standard storage.

INTELLIGENT_TIERING

The INTELLIGENT_TIERING storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead.

public static StorageClass INTELLIGENT_TIERING { get; }
Property Value

StorageClass

Remarks

INTELLIGENT_TIERING delivers automatic cost savings by moving data on a granular object level between two access tiers, a frequent access tier and a lower-cost infrequent access tier, when access patterns change. The INTELLIGENT_TIERING storage class is ideal if you want to optimize storage costs automatically for long-lived data when access patterns are unknown or unpredictable.

ONE_ZONE_INFREQUENT_ACCESS

Infrequent Access that's only stored in one availability zone.

public static StorageClass ONE_ZONE_INFREQUENT_ACCESS { get; }
Property Value

StorageClass

Remarks

Has lower availability than standard InfrequentAccess.

Value

Storage class to move an object to.

public virtual string Value { get; }
Property Value

string

Remarks

ExampleMetadata: infused

Examples
var bucket = new Bucket(this, "MyBucket", new BucketProps {
                LifecycleRules = new [] { new LifecycleRule {
                    AbortIncompleteMultipartUploadAfter = Duration.Minutes(30),
                    Enabled = false,
                    Expiration = Duration.Days(30),
                    ExpirationDate = new Date(),
                    ExpiredObjectDeleteMarker = false,
                    Id = "id",
                    NoncurrentVersionExpiration = Duration.Days(30),

                    // the properties below are optional
                    NoncurrentVersionsToRetain = 123,
                    NoncurrentVersionTransitions = new [] { new NoncurrentVersionTransition {
                        StorageClass = StorageClass.GLACIER,
                        TransitionAfter = Duration.Days(30),

                        // the properties below are optional
                        NoncurrentVersionsToRetain = 123
                    } },
                    ObjectSizeGreaterThan = 500,
                    Prefix = "prefix",
                    ObjectSizeLessThan = 10000,
                    Transitions = new [] { new Transition {
                        StorageClass = StorageClass.GLACIER,

                        // exactly one of transitionAfter or transitionDate must be specified
                        TransitionAfter = Duration.Days(30)
                    } }
                } }
            });

Methods

ToString()

Storage class to move an object to.

public override string ToString()
Returns

string

Remarks

ExampleMetadata: infused