使用 Amazon CLI 的 Amazon S3 入门

使用 s3api create-bucket 命令创建存储桶。将 amzn-s3-demo-bucket 替换为唯一的存储桶名称，并将 us-east-1 替换为您所需的区域：

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-east-1

对于 us-east-1 以外的区域，您需要指定位置限制：

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-west-2 --create-bucket-configuration LocationConstraint=us-west-2

通过列出所有存储桶来验证是否创建了您的存储桶：

aws s3 ls

对于对象所有权，您可以禁用或启用 ACL，并控制上传到存储桶的对象的所有权。

已禁用 ACL

要设置强制存储桶拥有者（默认）：ACL 已禁用，存储桶拥有者自动拥有并完全控制通用存储桶中的每个对象：

aws s3api put-bucket-ownership-controls --bucket amzn-s3-demo-bucket --ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"

已启用 ACL

检查存储桶的当前对象所有权设置：

aws s3api get-bucket-ownership-controls --bucket amzn-s3-demo-bucket

验证是否已启用屏蔽公共访问权限（默认情况下，对于新存储桶启用此设置）：

aws s3api get-public-access-block --bucket amzn-s3-demo-bucket

默认情况下，为新的存储桶启用所有四个屏蔽公共访问权限设置。我们建议您将所有设置保持为启用状态，除非您知道您需要为您的特定使用案例关闭其中一个或多个设置。有关屏蔽公共访问权限的更多信息，请参阅阻止对您的 Amazon S3 存储的公有访问。

如果您需要启用屏蔽公共访问权限，请使用以下命令：

aws s3api put-public-access-block --bucket amzn-s3-demo-bucket --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

为存储桶启用版本控制：

aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled

默认情况下，存储桶版本控制处于禁用状态。版本控制是在相同的存储桶中保留对象的多个变量的方法。对于 存储桶中存储的每个对象，您可以使用版本控制功能来保留、检索和还原它们的各个版本。使用版本控制能够更加轻松地从用户意外操作和应用程序故障中恢复数据。有关版本控制的更多信息，请参阅使用 S3 版本控制保留对象的多个版本。

Amazon S3 对象锁定有助于保护新对象不被删除或覆盖。有关更多信息，请参阅 使用对象锁定以锁定对象。要启用使用对象锁定以锁定对象（需要存储桶版本控制），请执行以下操作：

对于新存储桶：

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-east-1 --object-lock-enabled-for-bucket

对于现有存储桶：

aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket --object-lock-configuration '{"ObjectLockEnabled": "Enabled"}'

如果要在启用对象锁定的同时设置默认的使用对象锁定以锁定对象，可以使用：

aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket --object-lock-configuration '{"ObjectLockEnabled":"Enabled","Rule":{"DefaultRetention":{"Mode":"COMPLIANCE","Days":30}}}'

您可以将 "COMPLIANCE" 替换为 "GOVERNANCE" 以使用限制较少的模式，并根据需要调整天数。

您可以向存储桶添加标签。利用 Amazon 成本分配功能，可以使用存储桶标签来对存储桶的使用计费添加注释。一个标签即为一个键值对，用于表示用户分配给存储桶的标记。有关更多信息，请参阅 使用成本分配 S3 存储桶标签。

向存储桶添加标签：

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=Purpose,Value=Testing},{Key=Environment,Value=Development}]'

通过将具有 Amazon S3 托管式密钥的服务器端加密 (SSE-S3) 用作基本加密配置级别，对存储桶和新对象进行加密。要验证存储桶的默认加密，请使用以下命令：

aws s3api get-bucket-encryption --bucket amzn-s3-demo-bucket

您还可以为存储桶配置具有 Amazon KMS 密钥的服务器端加密 (SSE-KMS) 或具有 Amazon KMS 密钥的双层服务器加密 (DSSE-KMS)。Amazon 托管式密钥 (aws/s3) 和客户自主管理型密钥都可用作 SSE-KMS 和 DSSE-KMS 加密配置的 Amazon KMS 密钥。有关客户自主管理型密钥的更多信息，请参阅《Amazon Key Management Service 开发人员指南》中的客户密钥和 Amazon 密钥。有关创建 Amazon KMS 密钥的更多信息，请参阅《Amazon Key Management Service Developer Guide》中的 Creating keys。

当您将存储桶配置为使用具有 SSE-KMS 的默认加密时，您也可以使用 Amazon S3 存储桶密钥。Amazon S3 存储桶密钥可通过减少从 Amazon S3 到 Amazon KMS 的请求流量，来降低加密成本。有关更多信息，请参阅 使用 Amazon S3 存储桶密钥降低 SSE-KMS 的成本。DSSE-KMS 不支持 Amazon S3 存储桶密钥。在 Amazon CLI 中，当创建新的存储桶时，Amazon S3 存储桶密钥默认处于未启用状态。这与默认启用它们的控制台行为不同。

配置 SSE-KMS 并启用 Amazon S3 存储桶密钥：

aws s3api put-bucket-encryption --bucket amzn-s3-demo-bucket --server-side-encryption-configuration "{\"Rules\":[{\"ApplyServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"YOUR-KMS-KEY-ARN\"},\"BucketKeyEnabled\":true}]}"

检查是否为存储桶启用了 Amazon S3 存储桶密钥：

aws s3api get-bucket-encryption --bucket amzn-s3-demo-bucket

输出将包括一个设置为 true 或 false 的 BucketKeyEnabled 字段。

要配置 DSSE-KMS，请使用以下命令：

aws s3api put-bucket-encryption --bucket amzn-s3-demo-bucket --server-side-encryption-configuration '{"Rules":[{"ApplyServerSideEncryptionByDefault":{"SSEAlgorithm":"aws:kms:dsse","KMSMasterKeyID":"YOUR-KMS-KEY-ARN"}}]}'

有关默认加密的更多信息，请参阅为 Amazon S3 存储桶设置默认服务器端加密行为。有关 SSE-S3 的更多信息，请参阅使用具有 Amazon S3 托管式密钥的服务器端加密（SSE-S3）。

创建要上传的简单文本文件。您可以使用任何文本编辑器或运行以下命令：

echo 'Hello, Amazon S3!' > example.txt

使用 s3 cp 命令将文件上传到存储桶：

aws s3 cp example.txt s3://amzn-s3-demo-bucket/

如果上传成功，您将看到类似于以下内容的输出：

upload: ./example.txt to s3://amzn-s3-demo-bucket/example.txt

通过列出存储桶的内容来验证对象是否已上传：

aws s3 ls s3://amzn-s3-demo-bucket/

获取有关对象的信息：

aws s3api head-object --bucket amzn-s3-demo-bucket --key example.txt

此命令返回有关对象的元数据，包括其内容类型、内容长度和上次修改日期。

将对象下载到您的本地计算机：

aws s3 cp s3://amzn-s3-demo-bucket/example.txt downloaded-example.txt

如果下载成功，您将看到类似于以下内容的输出：

download: s3://amzn-s3-demo-bucket/example.txt to ./downloaded-example.txt

验证已下载文件的内容：

cat downloaded-example.txt

在 Amazon S3 中，文件夹由对象键中的前缀表示。通过复制带有前缀的对象来创建“文件夹”：

aws s3 cp s3://amzn-s3-demo-source-bucket/example.txt s3://amzn-s3-demo-destination-bucket/favorite-files/example.txt

如果复制成功，您将看到类似于以下内容的输出：

copy: s3://amzn-s3-demo-source-bucket/example.txt to s3://amzn-s3-demo-destination-bucket/favorite-files/example.txt

通过列出文件夹的内容来验证对象是否已复制：

aws s3 ls s3://amzn-s3-demo-destination-bucket/favorite-files/

选项 1：对于较小的存储桶，可以使用带有 --recursive 标志的 rm 命令来删除存储桶中的所有对象：

aws s3 rm s3://amzn-s3-demo-bucket --recursive

此命令删除存储桶中的所有对象，包括文件夹中的对象。

选项 2：使用 Amazon S3 生命周期规则（建议用于大型存储桶）

对于包含许多对象或大型对象的存储桶，请使用 Amazon S3 生命周期规则自动使所有对象过期并删除它们。等待生命周期规则进行处理（这可能需要长达 24 小时）。有关使用生命周期规则清空存储桶的更多信息，请参阅如何使用生命周期配置规则清空 Amazon S3 存储桶？

验证存储桶是否为空：

aws s3 ls s3://amzn-s3-demo-bucket

如果存储桶启用了版本控制，请使用以下命令来删除受版本控制的对象和删除标记。

移除受版本控制的对象：

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete "$(aws s3api list-object-versions --bucket amzn-s3-demo-bucket --output json --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')"

移除删除标记：

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete "$(aws s3api list-object-versions --bucket amzn-s3-demo-bucket --output json --query='{Objects: DeleteMarkers[].{Key:Key,VersionId:VersionId}}')"

验证存储桶是否已清空了所有对象版本和删除标记：

aws s3api list-object-versions --bucket amzn-s3-demo-bucket

输出应显示没有剩余任何版本或删除标记。

删除存储桶：

aws s3api delete-bucket --bucket amzn-s3-demo-bucket

通过列出所有存储桶来验证是否已删除了该存储桶：

aws s3 ls