Net::Amazon::S3::Vendor - Base class for vendor specific behaviour
version 0.92
# use it with Amazon AWS my $s3 = Net::Amazon::S3->new ( vendor => Net::Amazon::S3::Vendor::Amazon->new, ..., ); # or build your own vendor description my $vendor = Net::Amazon::S3::Vendor::Generic->new ( host => 'my.s3.service', use_https => 1, use_virtual_host => 1, authorization_method => 'Net::Amazon::S3::Signature::V2', ); # or my $vendor = Net::Amazon::S3::Vendor::Generic->new ( host => 'my.s3.service', use_https => 1, use_virtual_host => 1, authorization_method => 'Net::Amazon::S3::Signature::V4', default_region => '...', ); # and construct your s3 connection my $s3 = Net::Amazon::S3->new ( vendor => $vendor, ... );
S3 protocol is used not only by Amazon AWS but by many other object-storage services. They provide same API, but it's just there's a little difference.
Examples?
Allright, you can upload file but other provider does not support multipart uploads.
Or although some providers support Signature V4 they may not support HEAD bucket request to fetch it automatically.
Required, where service is located.
Available here so one can move its parameters into its own vendor class.
Default: Net::Amazon::S3::Signature::V2
Signature class used to authorize requests.
Default: true.
Whether to use HTTPS or not.
Default: whatever authorization_method enforces
authorization_method
Whether to use path or virtual host access style. Path style uses single host with bucket contained in uri path whereas virtual host style use bucket specific virtual hosts.
Default: undef
Value that guess_bucket_region will return.
guess_bucket_region
Use when your provider doesn't support HEAD region request but uses Signature V4 authorization method.
Returns bucket's region
Branislav Zahradník <barney@cpan.org>
This software is copyright (c) 2020 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Net::Amazon::S3, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Amazon::S3
CPAN shell
perl -MCPAN -e shell install Net::Amazon::S3
For more information on module installation, please visit the detailed CPAN module installation guide.