使用由 S3 存取授權提供的憑證來存取 S3 資料

承授者透過其存取授權取得臨時憑證後，可以使用這些臨時憑證呼叫 Amazon S3 API 操作來存取您的資料。

承授者可以使用 S3 AWS Command Line Interface (AWS CLI)、 AWS SDKs和 Amazon S3 REST API 來存取 S3 資料。此外，您可以使用 AWS Python 和 Java 外掛程式來呼叫 S3 Access Grants

使用 AWS CLI

承授者從 S3 Access Grants 取得其臨時憑證後，就可以設定包含這些憑證的設定檔來擷取資料。

若要安裝 AWS CLI，請參閱AWS Command Line Interface 《 使用者指南》中的安裝 AWS CLI 。

若要使用下列範例命令，請將 user input placeholders 取代為您自己的資訊。

範例 – 設定設定檔

aws configure set aws_access_key_id "$accessKey" --profile access-grants-consumer-access-profile
aws configure set aws_secret_access_key "$secretKey" --profile access-grants-consumer-access-profile
aws configure set aws_session_token "$sessionToken" --profile access-grants-consumer-access-profile

若要使用下列範例命令，請以您自己的資訊取代 user input placeholders。

範例 – 取得 S3 資料

承授者可以使用 get-object AWS CLI 命令來存取資料。承授者也可以使用 put-object、 ls和其他 S3 AWS CLI 命令。

aws s3api get-object \
--bucket amzn-s3-demo-bucket1 \
--key myprefix \
--region us-east-2 \
--profile access-grants-consumer-access-profile

使用 AWS CLI

承授者從 S3 Access Grants 取得其臨時憑證後，就可以設定包含這些憑證的設定檔來擷取資料。

若要安裝 AWS CLI，請參閱AWS Command Line Interface 《 使用者指南》中的安裝 AWS CLI 。

若要使用下列範例命令，請將 user input placeholders 取代為您自己的資訊。

範例 – 設定設定檔

aws configure set aws_access_key_id "$accessKey" --profile access-grants-consumer-access-profile
aws configure set aws_secret_access_key "$secretKey" --profile access-grants-consumer-access-profile
aws configure set aws_session_token "$sessionToken" --profile access-grants-consumer-access-profile

若要使用下列範例命令，請以您自己的資訊取代 user input placeholders。

範例 – 取得 S3 資料

承授者可以使用 get-object AWS CLI 命令來存取資料。承授者也可以使用 put-object、 ls和其他 S3 AWS CLI 命令。

aws s3api get-object \
--bucket amzn-s3-demo-bucket1 \
--key myprefix \
--region us-east-2 \
--profile access-grants-consumer-access-profile

使用 AWS SDKs

本節提供承授者如何使用 AWS SDK 存取 S3 資料的範例。

Java

如需如何使用臨時憑證取得 S3 資料的範例，請參閱如何使用 的 AWS SDKs和 Amazon S3 程式碼範例來取得物件。 Amazon S3 AWS SDK for Java 2.x

使用 AWS SDKs

本節提供承授者如何使用 AWS SDK 存取 S3 資料的範例。

Java

如需如何使用臨時憑證取得 S3 資料的範例，請參閱如何使用 的 AWS SDKs和 Amazon S3 程式碼範例來取得物件。 Amazon S3 AWS SDK for Java 2.x

S3 存取授權中支援的 S3 動作

承授者可以使用由 S3 存取授權提供的臨時憑證，對其可存取的 S3 資料執行 S3 動作。以下是承授者可執行的允許 S3 動作清單。哪些動作是允許的，取決於存取授權中授予的許可層級 (READ、WRITE 或 READWRITE)。

注意

除了下列 Amazon S3 許可之外，Amazon S3 還可以呼叫 AWS Key Management Service (AWS KMS) Decrypt (kms:decrypt) READ許可或 AWS KMS GenerateDataKey (kms:generateDataKey) WRITE許可。這些許可不允許直接存取 AWS KMS 金鑰。

S3 IAM 動作	API 動作與文件	S3 存取授權許可	S3 資源
s3:GetObject	GetObject	READ	物件
s3:GetObjectVersion	GetObject	READ	物件
s3:GetObjectAcl	GetObjectAcl	READ	物件
s3:GetObjectVersionAcl	GetObjectAcl	READ	物件
s3:ListMultipartUploads	ListParts	READ	物件
s3:PutObject	PutObject、CreateMultipartUpload、UploadPart、UploadPartCopy、CompleteMultipartUpload	WRITE	物件
s3:PutObjectAcl	PutObjectAcl	WRITE	物件
s3:PutObjectVersionAcl	PutObjectAcl	WRITE	物件
s3:DeleteObject	DeleteObject	WRITE	物件
s3:DeleteObjectVersion	DeleteObject	WRITE	物件
s3:AbortMultipartUpload	AbortMultipartUpload	WRITE	物件
s3:ListBucket	HeadBucket、ListObjectsV2、ListObjects	READ	儲存貯體
s3:ListBucketVersions	ListObjectVersions	READ	儲存貯體
s3:ListBucketMultipartUploads	ListMultipartUploads	READ	儲存貯體