ImageResizer.Plugins.S3Reader2
5.0.11-preview08
Prefix Reserved
See the version list below for details.
dotnet add package ImageResizer.Plugins.S3Reader2 --version 5.0.11-preview08
NuGet\Install-Package ImageResizer.Plugins.S3Reader2 -Version 5.0.11-preview08
<PackageReference Include="ImageResizer.Plugins.S3Reader2" Version="5.0.11-preview08" />
paket add ImageResizer.Plugins.S3Reader2 --version 5.0.11-preview08
#r "nuget: ImageResizer.Plugins.S3Reader2, 5.0.11-preview08"
// Install ImageResizer.Plugins.S3Reader2 as a Cake Addin #addin nuget:?package=ImageResizer.Plugins.S3Reader2&version=5.0.11-preview08&prerelease // Install ImageResizer.Plugins.S3Reader2 as a Cake Tool #tool nuget:?package=ImageResizer.Plugins.S3Reader2&version=5.0.11-preview08&prerelease
ImageResizer.Plugins.S3Reader2
Allows images located on Amazon S3 to be processed and resized as if they were located locally on the disk.
Example URLs
- http://localhost/s3/bucket-name/filename.jpg?width=100
- http://localhost/s3/bucket-name/folder/filename.jpg?width=100
See Samples/S3ReaderSample/ in the download for a sample project.
Features
- Fast - no unnecessary HTTP requests
- Offers mode for checking for newer files on a configured interval (useful when combined with disk caching)
- Works great with the DiskCache and CloudFront caching plugins
- Has an optional SSL mode
- Can be configured to access private bucket files with an access key
Installation
- Either
Install-Package ImageResizer.Plugins.S3Reader2
or add a reference to ImageResizer.Plugins.S3Reader2.dll. - Add
<add name="S3Reader2" prefix="~/s3" region="us-east-1" buckets="my-bucket-1,my-bucket-2,my-bucket-3" />
inside<plugins></plugins>
in Web.config.
Region IDs
The default region is 'us-east-1', which works for buckets in both 'us-east-1' and 'us-west-1', but not 'us-west-2' or any other buckets. Use multiple installations of S3Reader2 with different prefixes if you need to support multiple regions.
"us-east-1", "US East (Virginia)"
"us-west-1", "US West (N. California)"
"us-west-2", "US West (Oregon)"
"eu-west-1", "EU West (Ireland)"
"ap-northeast-1", "Asia Pacific (Tokyo)"
"ap-southeast-1", "Asia Pacific (Singapore)"
"ap-southeast-2", "Asia Pacific (Sydney)"
"sa-east-1", "South America (S�o Paulo)"
"us-gov-west-1", "US GovCloud West (Oregon)"
Notes on bucket naming
When creating a bucket, you should avoid certain characters to ensure that DNS works properly. While Amazon will let you create buckets that violate some of these rules, you may have trouble accessing them using the subdomain syntax or over HTTPS. Make sure every bucket is also a valid DNS address. Read more.
- Bucket names should not contain upper case letters
- Bucket names should not contain underscores (_)
- Bucket names should not end with a dash
- Bucket names should be between 3 and 63 characters long
- Bucket names cannot contain dashes next to periods (e.g., "my-.bucket.com" and "my.-bucket" are invalid)
- Bucket names cannot contain periods - Amazon states this is not supported for SSL-secured access, due to DNS complications. Your mileage may vary.
Configuration
You must specify a comma-delimited list of permitted bucket names that can be accessed.
If you want to access non-public bucket items, you will need to specify an access ID and key.
<add name="S3Reader2" buckets="my-bucket-1,my-bucket-2,my-bucket-3" prefix="~/s3/" checkForModifiedFiles="false" useSsl="false" accessKeyId="" secretAccessKey="" region="us-east-1" />
- buckets (required) - Comma-delimited list of permitted bucket names that can be accessed.
- region - Set to the region containing your buckets.
- useSsl - Defaults to false. Set to true to transfer the image data over an encrypted connection. Decreases performance.
- accessKeyId, secretAccessKey - Use these if you need to access non-public files in your amazon buckets.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
-
.NETFramework 4.7.2
- AWSSDK.Core (>= 3.7.12.25)
- AWSSDK.S3 (>= 3.7.9.43)
- ImageResizer (>= 5.0.11-preview08)
- ImageResizer.Storage (>= 5.0.11-preview08)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
5.0.13-preview09 | 127 | 9/30/2023 |
5.0.11-preview08 | 154 | 12/23/2022 |
5.0.10-preview07 | 119 | 11/17/2022 |
5.0.9-preview06 | 147 | 11/4/2022 |
5.0.8-preview05 | 149 | 11/4/2022 |
5.0.7-preview-04 | 169 | 10/14/2022 |
5.0.6-preview03 | 160 | 10/14/2022 |
5.0.5-preview02 | 157 | 9/29/2022 |
5.0.4-preview01 | 162 | 8/26/2022 |
5.0.3-preview04 | 137 | 8/26/2022 |
5.0.2-preview03 | 163 | 8/25/2022 |
5.0.1-preview02 | 160 | 8/25/2022 |
4.2.8 | 2,622 | 7/31/2020 |
4.2.7-pre | 353 | 7/14/2020 |
4.2.6-pre | 470 | 11/2/2019 |
4.2.5 | 36,173 | 4/6/2018 |
4.2.5-pre | 915 | 2/19/2018 |
4.2.4-pre | 873 | 12/13/2017 |
4.2.3-pre | 728 | 12/13/2017 |
4.2.1-pre | 741 | 11/29/2017 |
4.2.0 | 7,042 | 11/28/2017 |
4.1.11 | 932 | 11/8/2017 |
4.1.10 | 1,741 | 9/13/2017 |
4.1.9 | 2,071 | 6/22/2017 |
4.1.8 | 964 | 6/17/2017 |
4.1.7 | 1,053 | 6/6/2017 |
4.1.7-rc | 793 | 6/5/2017 |
4.1.6-rc | 799 | 6/1/2017 |
4.1.5-rc | 753 | 6/1/2017 |
4.1.4-rc | 797 | 5/11/2017 |
4.1.3-rc | 783 | 5/11/2017 |
4.1.3-preview | 840 | 5/6/2017 |
4.1.3-beta | 778 | 5/5/2017 |
4.0.5 | 26,042 | 1/31/2016 |
4.0.4 | 2,040 | 10/25/2015 |
4.0.3 | 1,031 | 10/25/2015 |
4.0.2 | 1,030 | 10/25/2015 |
4.0.1 | 1,083 | 10/25/2015 |
4.0.0-prerelease0881 | 1,377 | 8/11/2015 |
4.0.0-prerelease0877 | 898 | 7/7/2015 |
3.4.3 | 35,798 | 5/8/2014 |
3.4.2 | 1,656 | 11/26/2013 |