AWScurl笔记

摘要

AWScurl是一款专为与AWS服务交互设计的命令行工具，它模拟了curl的功能并添加了AWS签名版本4的支持。这一特性使得用户能够安全有效地执行带有AWS签名的请求，极大地提升了与AWS服务交互时的安全性和有效性。
GitHub - okigan/awscurl: curl-like access to AWS resources with AWS Signature Version 4 request signing.curl-like access to AWS resources with AWS Signature Version 4 request signing. - okigan/awscurlhttps://github.com/okigan/awscurlhttps://github.com/okigan/awscurl

一、AWScurl入门与基础操作

1.1 AWScurl概述

AWScurl是一款专为与AWS服务交互设计的命令行工具，它模拟了curl的功能并添加了AWS签名版本4的支持。这一特性使得用户能够安全有效地执行带有AWS签名的请求，极大地提升了与AWS服务交互时的安全性和有效性。AWScurl的设计初衷是为了简化开发者在使用AWS API时的操作流程，同时保证数据传输的安全性。它适用于各种场景，无论是开发测试还是生产环境下的自动化脚本编写，都能发挥重要作用。

1.2 工具安装与配置

安装步骤

Python环境准备：由于AWScurl基于Python开发，因此首先需要确保系统中已安装Python环境。推荐使用Python 3.x版本。
安装AWScurl：可以通过pip命令直接安装AWScurl，命令如下：
```
pip install awscurl
```

配置AWS凭证

为了使AWScurl能够正确地为请求生成签名，需要配置AWS访问密钥（Access Key ID）和秘密访问密钥（Secret Access Key）。可以通过以下几种方式之一来设置这些凭证：

环境变量：设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY环境变量。
配置文件：创建一个名为~/.aws/credentials的文件，并在其中添加如下内容：
```
[default]aws_access_key_id = YOUR_ACCESS_KEYaws_secret_access_key = YOUR_SECRET_KEY
```
命令行参数：在运行awscurl命令时直接传递访问密钥和秘密访问密钥作为参数。

其他可选配置

区域：指定AWS服务所在的区域，可以通过--region参数设置。
端点URL：如果需要连接到特定的端点URL，可以使用--endpoint-url参数指定。

1.3 基本命令使用说明

基础用法

AWScurl的基本使用方法类似于curl，但增加了AWS签名相关的选项。下面是一个简单的示例，用于向bedrock发送post请求：

awscurl -v -i \--request POST \--service bedrock https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-sonnet-20241022-v2:0/converse \--data '{"messages":[{"role":"user","content":[{"text":"Provide general steps to debug a BSOD on a Windows laptop."}]}],"system":[{"text":"You are a tech support expert who helps resolve technical issues. Signal SUCCESS if you can resolve the issue, otherwise FAILURE"}],"inferenceConfig":{"stopSequences":["SUCCESS","FAILURE"]},"additionalModelRequestFields":{"top_k":200}}'

常用选项

-v 输出debug信息
--service: 指定AWS服务类型，例如s3、ec2等。
--region: 指定AWS服务所在的区域。
--request: 指定HTTP请求方法，默认为GET。
--data: 发送POST请求时携带的数据。
--headers: 添加自定义HTTP头。

更详细参数请参考：

[root@localhost build]# awscurl -h
usage: awscurl [-h] [-v] [-i] [-X REQUEST] [-d DATA] [-H HEADER] [-k][--fail-with-body] [--data-binary] [--region REGION][--profile PROFILE] [--service SERVICE][--access_key ACCESS_KEY] [--secret_key SECRET_KEY][--security_token SECURITY_TOKEN][--session_token SESSION_TOKEN] [-L] [-o <file>]uriCurl AWS request signingpositional arguments:urioptional arguments:-h, --help            show this help message and exit-v, --verbose         verbose flag (default: False)-i, --include         include headers in the output (default: False)-X REQUEST, --request REQUESTSpecify request command to use (default: GET)-d DATA, --data DATA  HTTP POST data (default: )-H HEADER, --header HEADERHTTP header (default: None)-k, --insecure        Allow insecure server connections when using SSL(default: False)--fail-with-body      Fail on HTTP errors but save the body (default: False)--data-binary         Process HTTP POST data exactly as specified with noextra processing whatsoever. (default: False)--region REGION       AWS region [env var: AWS_DEFAULT_REGION] (default: us-east-1)--profile PROFILE     AWS profile [env var: AWS_PROFILE] (default: default)--service SERVICE     AWS service (default: execute-api)--access_key ACCESS_KEY[env var: AWS_ACCESS_KEY_ID] (default: None)--secret_key SECRET_KEY[env var: AWS_SECRET_ACCESS_KEY] (default: None)--security_token SECURITY_TOKEN[env var: AWS_SECURITY_TOKEN] (default: None)--session_token SESSION_TOKEN[env var: AWS_SESSION_TOKEN] (default: None)-L, --location        Follow redirects (default: False)-o <file>, --output <file>Write to file instead of stdout (default: )In general, command-line values override environment variables which override
defaults.