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

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

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

• ARN – arn:aws:s3:region:account-id:accesspoint/my-access-point

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

如需有關的詳細資訊ARNs，請參閱中的 Amazon 資源名稱 (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 services。

如下所示 AWS CLI get-object命令的範例會使用值區的存取點別名來傳回指定物件的相關資訊。若要執行此命令，請以您自己的資訊取代 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 簡單儲存服務API參考中的 Amazon S3 控制。

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

• 別名不能用於 AWS Identity and Access Management (IAM) 政策。

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

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

• Amazon SageMaker GroundTruth 不支持接入點別名。