# Use `RestoreObject` with an AWS SDK or CLI
The following code examples show how to use `RestoreObject`.
------
#### [ .NET ]
**SDK for .NET**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/S3#code-examples).
```
using System;
using System.Threading.Tasks;
using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
///
/// This example shows how to restore an archived object in an Amazon
/// Simple Storage Service (Amazon S3) bucket.
///
public class RestoreArchivedObject
{
public static void Main()
{
string bucketName = "amzn-s3-demo-bucket";
string objectKey = "archived-object.txt";
// Specify your bucket region (an example region is shown).
RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
IAmazonS3 client = new AmazonS3Client(bucketRegion);
RestoreObjectAsync(client, bucketName, objectKey).Wait();
}
///
/// This method restores an archived object from an Amazon S3 bucket.
///
/// The initialized Amazon S3 client object used to call
/// RestoreObjectAsync.
/// A string representing the name of the
/// bucket where the object was located before it was archived.
/// A string representing the name of the
/// archived object to restore.
public static async Task RestoreObjectAsync(IAmazonS3 client, string bucketName, string objectKey)
{
try
{
var restoreRequest = new RestoreObjectRequest
{
BucketName = bucketName,
Key = objectKey,
Days = 2,
};
RestoreObjectResponse response = await client.RestoreObjectAsync(restoreRequest);
// Check the status of the restoration.
await CheckRestorationStatusAsync(client, bucketName, objectKey);
}
catch (AmazonS3Exception amazonS3Exception)
{
Console.WriteLine($"Error: {amazonS3Exception.Message}");
}
}
///
/// This method retrieves the status of the object's restoration.
///
/// The initialized Amazon S3 client object used to call
/// GetObjectMetadataAsync.
/// A string representing the name of the Amazon
/// S3 bucket which contains the archived object.
/// A string representing the name of the
/// archived object you want to restore.
public static async Task CheckRestorationStatusAsync(IAmazonS3 client, string bucketName, string objectKey)
{
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest()
{
BucketName = bucketName,
Key = objectKey,
};
GetObjectMetadataResponse response = await client.GetObjectMetadataAsync(metadataRequest);
var restStatus = response.RestoreInProgress ? "in-progress" : "finished or failed";
Console.WriteLine($"Restoration status: {restStatus}");
}
}
```
+ For API details, see [RestoreObject](https://docs.aws.amazon.com/goto/DotNetSDKV3/s3-2006-03-01/RestoreObject) in *AWS SDK for .NET API Reference*.
------
#### [ CLI ]
**AWS CLI**
**To create a restore request for an object**
The following `restore-object` example restores the specified Amazon S3 Glacier object for the bucket `my-glacier-bucket` for 10 days.
```
aws s3api restore-object \
--bucket my-glacier-bucket \
--key doc1.rtf \
--restore-request Days=10
```
This command produces no output.
+ For API details, see [RestoreObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/restore-object.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/s3#code-examples).
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.RestoreRequest;
import software.amazon.awssdk.services.s3.model.GlacierJobParameters;
import software.amazon.awssdk.services.s3.model.RestoreObjectRequest;
import software.amazon.awssdk.services.s3.model.S3Exception;
import software.amazon.awssdk.services.s3.model.Tier;
/*
* For more information about restoring an object, see "Restoring an archived object" at
* https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html
*
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class RestoreObject {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
bucketName - The Amazon S3 bucket name.\s
keyName - The key name of an object with a Storage class value of Glacier.\s
expectedBucketOwner - The account that owns the bucket (you can obtain this value from the AWS Management Console).\s
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String bucketName = args[0];
String keyName = args[1];
String expectedBucketOwner = args[2];
Region region = Region.US_EAST_1;
S3Client s3 = S3Client.builder()
.region(region)
.build();
restoreS3Object(s3, bucketName, keyName, expectedBucketOwner);
s3.close();
}
/**
* Restores an S3 object from the Glacier storage class.
*
* @param s3 an instance of the {@link S3Client} to be used for interacting with Amazon S3
* @param bucketName the name of the S3 bucket where the object is stored
* @param keyName the key (object name) of the S3 object to be restored
* @param expectedBucketOwner the AWS account ID of the expected bucket owner
*/
public static void restoreS3Object(S3Client s3, String bucketName, String keyName, String expectedBucketOwner) {
try {
RestoreRequest restoreRequest = RestoreRequest.builder()
.days(10)
.glacierJobParameters(GlacierJobParameters.builder().tier(Tier.STANDARD).build())
.build();
RestoreObjectRequest objectRequest = RestoreObjectRequest.builder()
.expectedBucketOwner(expectedBucketOwner)
.bucket(bucketName)
.key(keyName)
.restoreRequest(restoreRequest)
.build();
s3.restoreObject(objectRequest);
} catch (S3Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ For API details, see [RestoreObject](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3-2006-03-01/RestoreObject) in *AWS SDK for Java 2.x API Reference*.
------
For a complete list of AWS SDK developer guides and code examples, see [Developing with Amazon S3 using the AWS SDKs](sdk-general-information-section.md). This topic also includes information about getting started and details about previous SDK versions.