IAmazonS3.GetPreSignedURL (GetPreSignedUrlRequest)

The following examples show how to create various different pre-signed URLs.

The code sample shows a GetContents function. This will be referred to in subsequent samples to test out the generated URL.

GetContents function

public static async Task<string> GetContents(string path)
{
    using var httpClient = new HttpClient();
    return await httpClient.GetStringAsync(path);
}
        
        

The first example creates a URL that will allow a third party to retrieve an object from S3 for a period of 5 minutes.

GetPreSignedURL sample 1

// Create a client
AmazonS3Client client = new AmazonS3Client();

// Create a CopyObject request
GetPreSignedUrlRequest request = new GetPreSignedUrlRequest
{
    BucketName = "amzn-s3-demo-bucket",
    Key = "Item1",
    Expires = DateTime.UtcNow.AddMinutes(5)
};

// Get path for request
string path = await client.GetPreSignedURLAsync(request);

// Test by getting contents
string contents = await GetContents(path);

                

The following example creates a URL that will allow a third party to retrieve an object from S3 for a period of 5 minutes, and it also sets the headers to specific content, caching and encoding values.

GetPreSignedURL sample 2

// Create a client
AmazonS3Client client = new AmazonS3Client();

// Create a CopyObject request
GetPreSignedUrlRequest request = new GetPreSignedUrlRequest
{
    BucketName = "amzn-s3-demo-bucket",
    Key = "Item1",
    Expires = DateTime.UtcNow.AddMinutes(5)
};
request.ResponseHeaderOverrides.ContentType = "text/xml+zip";
request.ResponseHeaderOverrides.ContentDisposition = "attachment; filename=dispName.pdf";
request.ResponseHeaderOverrides.CacheControl = "No-cache";
request.ResponseHeaderOverrides.ContentLanguage = "mi, en";
request.ResponseHeaderOverrides.Expires = "Thu, 01 Dec 1994 16:00:00 GMT";
request.ResponseHeaderOverrides.ContentEncoding = "x-gzip";

// Get path for request
string path = await client.GetPreSignedURLAsync(request);

// Test by getting contents
string contents = await GetContents(path);

                

This example creates a URL that will allow a third party to list all objects in a specific bucket. This URL will also expire in 5 minutes.
The URL response will be the XML response for a ListBucket request.

GetPreSignedURL sample 3

// Create a client
AmazonS3Client client = new AmazonS3Client();

// Create a CopyObject request
GetPreSignedUrlRequest request = new GetPreSignedUrlRequest
{
    BucketName = "amzn-s3-demo-bucket",
    Expires = DateTime.UtcNow.AddMinutes(5)
};

// Get path for request
string path = await client.GetPreSignedURLAsync(request);

// Retrieve objects
string allObjects = await GetContents(path);

                

This example creates a URL that will allow a third party to list all of the owner's buckets. This URL will also expire in 5 minutes.
The URL response will be the XML response for a ListBuckets request.

GetPreSignedURL sample 4

// Create a client
AmazonS3Client client = new AmazonS3Client();

// Create a CopyObject request
GetPreSignedUrlRequest request = new GetPreSignedUrlRequest
{
    Expires = DateTime.UtcNow.AddMinutes(5)
};

// Get path for request
string path = await client.GetPreSignedURLAsync(request);

// Retrieve buckets
string allBuckets = await GetContents(path);

                

This final example creates a URL that allows a third party to put an object, then uses it to upload sample content. The URL is set to expire in 10 days.

GetPreSignedURL sample 5

// Create a client
AmazonS3Client client = new AmazonS3Client();

// Create a CopyObject request
GetPreSignedUrlRequest request = new GetPreSignedUrlRequest
{
    BucketName = "amzn-s3-demo-bucket",
    Key = "Item1",
    Verb = HttpVerb.PUT,
    Expires = DateTime.UtcNow.AddDays(10)
};

// Get path for request
string path = await client.GetPreSignedURLAsync(request);

// Prepare data
byte[] data = UTF8Encoding.UTF8.GetBytes("Sample text.");

using var httpClient = new HttpClient();
using var httpRequest = new HttpRequestMessage(HttpMethod.Put, path)
{
    Content = new ByteArrayContent(data)
};

using var httpResponse = await httpClient.SendAsync(httpRequest);