針對您的 S3 儲存貯體存取點使用儲存貯體樣式別名 - Amazon Simple Storage Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

針對您的 S3 儲存貯體存取點使用儲存貯體樣式別名

在您建立存取點時,Amazon S3 會自動產生可使用的別名,而不是儲存貯體名稱來進行資料存取。您可以使用此存取點別名,而不是 Amazon Resource Name (ARN) 進行存取點資料平面操作。如需這些操作的清單,請參閱 存取點與 AWS 服務的相容性

以下顯示名為 之存取點的範例ARN和存取點別名my-access-point

  • ARNarn:aws:s3:region:account-id:accesspoint/my-access-point

  • 存取點別名my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

如需 的詳細資訊ARNs,請參閱 中的 Amazon Resource Names (ARNs)AWS 一般參考

存取點別名

存取點別名是在與 Amazon S3 儲存貯體相同的命名空間內建立的。此別名會自動產生且無法變更。存取點別名符合有效 Amazon S3 儲存貯體名稱的所有要求,並由下列部分組成:

access point prefix-metadata-s3alias

注意

存取點別名會保留該 -s3alias 尾碼,且該尾碼不能用於儲存貯體或存取點名稱。如需 Amazon S3 儲存貯體命名規則的詳細資訊,請參閱儲存貯體命名規則

存取點別名使用案例和限制

採用存取點時,可以使用存取點別名,而不需要進行大量的程式碼變更。

建立存取點時,Amazon S3 會自動產生存取點別名,如下列範例所示。若要執行此命令,請以您自己的資訊取代 user input placeholders

aws s3control create-access-point --bucket amzn-s3-demo-bucket1 --name my-access-point --account-id 111122223333 { "AccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point", "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias" }

您可以在任何資料平面操作中使用此存取點別名,而不是 Amazon S3 儲存貯體名稱。如需這些操作的清單,請參閱 存取點與 AWS 服務的相容性

下列 get-object命令 AWS CLI 範例使用儲存貯體的存取點別名來傳回指定物件的相關資訊。若要執行此命令,請以您自己的資訊取代 user input placeholders

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf { "AcceptRanges": "bytes", "LastModified": "2020-01-08T22:16:28+00:00", "ContentLength": 910, "ETag": "\"00751974dc146b76404bb7290f8f51bb\"", "VersionId": "null", "ContentType": "text/rtf", "Metadata": {} }

限制

  • 客戶無法設定別名。

  • 存取點上的別名無法刪除、修改或停用。

  • 您可以在某些資料平面操作中使用此存取點別名,而不是 Amazon S3 儲存貯體名稱。如需這些操作的清單,請參閱 存取點與 S3 操作的相容性.

  • Amazon S3 控制平面操作無法使用存取點別名。如需 Amazon S3 控制平面操作的清單,請參閱 Amazon Simple Storage Service API參考 中的 Amazon Amazon S3 控制

  • 您無法在 Amazon S3 主控台中使用 S3 存取點別名作為移動操作的來源或目的地。 Amazon S3

  • 別名無法在 AWS Identity and Access Management (IAM) 政策中使用。

  • 別名不能用作 S3 伺服器存取日誌的記錄目的地。

  • 別名無法用作 AWS CloudTrail 日誌的記錄目的地。

  • Amazon SageMaker GroundTruth 不支援存取點別名。