AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Object is archived and inaccessible until restored.

If the object you are retrieving is stored in the S3 Glacier Flexible Retrieval storage class, the S3 Glacier Deep Archive storage class, the S3 Intelligent-Tiering Archive Access tier, or the S3 Intelligent-Tiering Deep Archive Access tier, before you can retrieve the object you must first restore a copy using RestoreObject. Otherwise, this operation returns an InvalidObjectState error. For information about restoring archived objects, see Restoring Archived Objects in the Amazon S3 User Guide.

Inheritance Hierarchy

System.Object
  System.Exception
    Amazon.Runtime.AmazonServiceException
      Amazon.S3.AmazonS3Exception
        Amazon.S3.Model.InvalidObjectStateException

Namespace: Amazon.S3.Model
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C#
public class InvalidObjectStateException : AmazonS3Exception
         ISerializable

The InvalidObjectStateException type exposes the following members

Constructors

NameDescription
Public Method InvalidObjectStateException()

Default constructor for InvalidObjectStateException message.

Public Method InvalidObjectStateException(string)

Constructs a new InvalidObjectStateException with the specified error message.

Public Method InvalidObjectStateException(string, Exception)

Construct instance of InvalidObjectStateException

Public Method InvalidObjectStateException(Exception)

Construct instance of InvalidObjectStateException

Public Method InvalidObjectStateException(string, Exception, ErrorType, string, string, HttpStatusCode)

Construct instance of InvalidObjectStateException

Public Method InvalidObjectStateException(string, ErrorType, string, string, HttpStatusCode)

Construct instance of InvalidObjectStateException

Public Method InvalidObjectStateException(string, Exception, ErrorType, string, string, HttpStatusCode, string, string)

Construct instance of InvalidObjectStateException

Properties

NameTypeDescription
Public Property AccessTier Amazon.S3.IntelligentTieringAccessTier

Gets and sets the property AccessTier.

Public Property AmazonCloudFrontId System.String Inherited from Amazon.S3.AmazonS3Exception.
Public Property AmazonId2 System.String Inherited from Amazon.S3.AmazonS3Exception.
Public Property Data System.Collections.IDictionary Inherited from System.Exception.
Public Property ErrorCode System.String Inherited from Amazon.Runtime.AmazonServiceException.
Public Property ErrorType Amazon.Runtime.ErrorType Inherited from Amazon.Runtime.AmazonServiceException.
Public Property HelpLink System.String Inherited from System.Exception.
Public Property HResult System.Int32 Inherited from System.Exception.
Public Property InnerException System.Exception Inherited from System.Exception.
Public Property Message System.String Inherited from Amazon.S3.AmazonS3Exception.
Public Property RequestId System.String Inherited from Amazon.Runtime.AmazonServiceException.
Public Property ResponseBody System.String Inherited from Amazon.S3.AmazonS3Exception.
Public Property Retryable Amazon.Runtime.RetryableDetails Inherited from Amazon.Runtime.AmazonServiceException.
Public Property Source System.String Inherited from System.Exception.
Public Property StackTrace System.String Inherited from System.Exception.
Public Property StatusCode System.Net.HttpStatusCode Inherited from Amazon.Runtime.AmazonServiceException.
Public Property StorageClass Amazon.S3.S3StorageClass

Gets and sets the property StorageClass.

Public Property TargetSite System.Reflection.MethodBase Inherited from System.Exception.

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.7.2 or higher.

NameDescription
Public Method GetObjectData(SerializationInfo, StreamingContext)

Sets the System.Runtime.Serialization.SerializationInfo with information about the exception.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer