.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Net::Amazon::S3::Vendor 3pm"
.TH Net::Amazon::S3::Vendor 3pm "2020-10-09" "perl v5.30.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Net::Amazon::S3::Vendor \- Base class for vendor specific behaviour
.SH "VERSION"
.IX Header "VERSION"
version 0.97
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 5
\&        # 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                 => \*(Aqmy.s3.service\*(Aq,
\&                use_https            => 1,
\&                use_virtual_host     => 1,
\&                authorization_method => \*(AqNet::Amazon::S3::Signature::V2\*(Aq,
\&        );
\&
\&        # or
\&        my $vendor = Net::Amazon::S3::Vendor::Generic\->new (
\&                host                 => \*(Aqmy.s3.service\*(Aq,
\&                use_https            => 1,
\&                use_virtual_host     => 1,
\&                authorization_method => \*(AqNet::Amazon::S3::Signature::V4\*(Aq,
\&                default_region       => \*(Aq...\*(Aq,
\&        );
\&
\&        # and construct your s3 connection
\&        my $s3 = Net::Amazon::S3\->new (
\&                vendor => $vendor,
\&                ...
\&        );
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
S3 protocol is used not only by Amazon \s-1AWS\s0 but by many other object-storage services.
They provide same \s-1API,\s0 but it's just there's a little difference.
.PP
Examples?
.PP
Allright, you can upload file but other provider does not support multipart uploads.
.PP
Or although some providers support Signature V4 they may not support \s-1HEAD\s0 bucket request
to fetch it automatically.
.SS "Properties"
.IX Subsection "Properties"
\fIhost\fR
.IX Subsection "host"
.PP
Required, where service is located.
.PP
Available here so one can move its parameters into its own vendor class.
.PP
\fIauthorization_method\fR
.IX Subsection "authorization_method"
.PP
Default: Net::Amazon::S3::Signature::V2
.PP
Signature class used to authorize requests.
.PP
\fIuse_https\fR
.IX Subsection "use_https"
.PP
Default: true.
.PP
Whether to use \s-1HTTPS\s0 or not.
.PP
\fIuse_virtual_host\fR
.IX Subsection "use_virtual_host"
.PP
Default: whatever \f(CW\*(C`authorization_method\*(C'\fR enforces
.PP
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.
.PP
\fIdefault_region\fR
.IX Subsection "default_region"
.PP
Default: undef
.PP
Value that \f(CW\*(C`guess_bucket_region\*(C'\fR will return.
.PP
Use when your provider doesn't support \s-1HEAD\s0 region request but uses Signature V4 authorization
method.
.SS "Methods"
.IX Subsection "Methods"
\fIguess_bucket_region ($bucket)\fR
.IX Subsection "guess_bucket_region ($bucket)"
.PP
Returns bucket's region
.SH "AUTHOR"
.IX Header "AUTHOR"
Branislav Zahradník <barney@cpan.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2020 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.