使用 ARNs、存取點別名或虛擬託管型 URIs 參考存取點 - Amazon Simple Storage Service
存取點 ARNs存取點別名虛擬託管樣式 URI

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

使用 ARNs、存取點別名或虛擬託管型 URIs 參考存取點

建立存取點之後，您可以使用這些端點來執行許多操作。參考存取點時，您可以使用 Amazon Resource Name (ARNs)、存取點別名或虛擬託管樣式的 URI。

存取點 ARNs

存取點具有 Amazon Resource Name (ARN)。存取點 ARNs 類似於儲存貯體 ARNs，但會明確輸入和編碼存取點的 AWS 區域 和存取點擁有者的 AWS 帳戶 ID。如需 ARNs 的詳細資訊，請參閱《IAM 使用者指南》中的使用 Amazon Resource Name (ARNs) 識別 AWS 資源。

存取點 ARNs使用以下格式：

arn:aws:s3:region:account-id:accesspoint/resource

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test 代表區域 us-west-2 中由帳戶 123456789012 所擁有名為 test 的存取點。

  • arn:aws:s3:us-west-2:123456789012:accesspoint/* 代表區域 us-west-2 中帳戶 123456789012 下的所有存取點。

透過存取點存取之物件的 ARNs 使用以下格式：

arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01 代表透過區域 us-west-2 中由帳戶 123456789012 所擁有名為 test 之存取點存取的物件 unit-01。

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/* 代表區域 us-west-2 之帳戶 123456789012 中名為 test 之存取點的所有物件。

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01/finance/* 代表區域 us-west-2 帳戶 123456789012 中名為 test 的存取點之具有字首 unit-01/finance/ 的所有物件。

存取點別名

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

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

ACCESS POINT NAME-METADATA-s3alias （適用於連接至 Amazon S3 儲存貯體的存取點）

ACCESS POINT NAME-METADATA-ext-s3alias （適用於連接至non-S3 儲存貯體資料來源的存取點）

注意

-s3alias 和 -ext-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 儲存貯體名稱。如需這些操作的清單，請參閱 存取點相容性。

下列 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 S3 控制。

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

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

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

  • 別名不能用作 AWS CloudTrail 日誌的記錄目的地。

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

虛擬託管樣式 URI

存取點僅支援虛擬主機樣式定址。在虛擬託管樣式的 URI 中，存取點名稱 AWS 帳戶和 AWS 區域 是 URL 中網域名稱的一部分。如需虛擬託管的詳細資訊，請參閱 一般用途儲存貯體的虛擬託管。

存取點的虛擬託管樣式 URI 使用以下格式：

https://access-point-name-account-id.s3-accesspoint.region.amazonaws.com
注意

  • 如果您的存取點名稱包含破折號 (-) 字元，請在 URL 中加入破折號，並在帳戶 ID 之前插入另一個破折號。例如，若要使用區域 finance-docs 中由 123456789012 帳戶所擁有名為 us-west-2 的存取點，則適當的 URL 是 https://finance-docs-123456789012.s3-accesspoint.us-west-2.amazonaws.com。

  • S3 存取點不支援透過 HTTP 存取。存取點僅支援透過 HTTPS 的安全存取。