xref: /curl/docs/cmdline-opts/aws-sigv4.md (revision fe9f68fa)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: aws-sigv4
5Protocols: HTTP
6Arg: <provider1[:prvdr2[:reg[:srv]]]>
7Help: AWS V4 signature auth
8Category: auth http
9Added: 7.75.0
10Multi: single
11See-also:
12  - basic
13  - user
14Example:
15  - --aws-sigv4 "aws:amz:us-east-2:es" --user "key:secret" $URL
16---
17
18# `--aws-sigv4`
19
20Use AWS V4 signature authentication in the transfer.
21
22The provider argument is a string that is used by the algorithm when creating
23outgoing authentication headers.
24
25The region argument is a string that points to a geographic area of
26a resources collection (region-code) when the region name is omitted from
27the endpoint.
28
29The service argument is a string that points to a function provided by a cloud
30(service-code) when the service name is omitted from the endpoint.
31