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

使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。每次建立儲存貯體的存取點時，S3 on Outposts 都會自動產生存取點別名。您可以針對任何資料平面操作使用此存取點別名，而不是存取點 Amazon Resource Name (ARN)。例如，您可以使用存取點別名來執行物件層級操作，例如 PUT、GET、LIST 等等。如需這些操作的清單，請參閱 適用於管理物件的 Amazon S3 API 操作。

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

• 存取點 ARN – arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/my-access-point

• 存取點別名 – my-access-po-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3

如需 ARN 的詳細資訊，請參閱《AWS 一般參考》中的 Amazon Resource Name (ARN)。

如需存取點別名的詳細資訊，請參閱下列主題。

存取點別名

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

access point name prefix-metadata--op-s3

注意

--op-s3 尾碼保留給存取點別名，因此建議不要將其用於儲存貯體或存取點名稱。如需 S3 on Outposts 儲存貯體命名規則的詳細資訊，請參閱 使用 S3 on Outposts 儲存貯體。

尋找存取點別名

下列範例向您展示如何使用 Amazon S3 主控台和 AWS CLI尋找存取點別名。

範例 ：在 Amazon S3 主控台中尋找並複製存取點別名

在主控台中建立存取點之後，您可以從 Access Points (存取點) 清單中的 Access Point alias (存取點別名) 欄取得存取點別名。

複製存取點別名

1. 開啟位於 https://console.aws.amazon.com/s3/ 的 Amazon S3 主控台。

2. 在左側導覽窗格中，選擇 Outposts access points (Outposts 存取點)。

3. 若要複製存取點別名，請執行下列其中一項動作：

   • 在 Access Points (存取點) 清單中，選取存取點名稱旁邊的選項按鈕，然後選擇 Copy Access Point alias (複製存取點別名)。

   • 選擇存取點名稱。然後，在 Outposts access point overview (Outposts 存取點概觀) 下，複製存取點別名。

範例 ：使用 建立存取點， AWS CLI 並在回應中尋找存取點別名

下列 create-access-point命令 AWS CLI 範例會建立存取點，並傳回自動產生的存取點別名。若要執行此命令，請以您自己的資訊取代 user input placeholders。

aws s3control create-access-point --bucket example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "AccessPointArn":
    "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
    "Alias": "example-outp-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}

範例 ：使用 取得存取點別名 AWS CLI

下列 get-access-point命令 AWS CLI 範例會傳回指定存取點的相關資訊。此資訊包括存取點別名。若要執行此命令，請以您自己的資訊取代 user input placeholders。

aws s3control get-access-point --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "Name": "example-outposts-access-point",
    "Bucket": "example-outposts-bucket",
    "NetworkOrigin": "Vpc",
    "VpcConfiguration": {
        "VpcId": "vpc-01234567890abcdef"
    },
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": true,
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "RestrictPublicBuckets": true
    },
    "CreationDate": "2022-09-18T17:49:15.584000+00:00",
    "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}

範例 ：使用 列出存取點以尋找存取點別名 AWS CLI

list-access-points 命令的下列 AWS CLI 範例會列出指定存取點的相關資訊。此資訊包括存取點別名。若要執行此命令，請以您自己的資訊取代 user input placeholders。

aws s3control list-access-points --account-id 123456789012 --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket

{
    "AccessPointList": [
        {
            "Name": "example-outposts-access-point",
            "NetworkOrigin": "Vpc",
            "VpcConfiguration": {
                "VpcId": "vpc-01234567890abcdef"
            },
            "Bucket": "example-outposts-bucket",
            "AccessPointArn": "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
            "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
        }
    ]
}

在 S3 on Outposts 物件操作中使用存取點別名

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

此 AWS CLI 範例顯示 S3 on Outposts 儲存貯體get-object的操作。此範例會使用存取點別名作為 --bucket 的值，而非完整存取點 ARN。

aws s3api get-object --bucket my-access-po-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3 --key  testkey  sample-object.rtf

{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}

限制

• 客戶無法設定別名。

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

• 您無法將存取點別名用於 S3 on Outposts 控制平面操作。如需 S3 on Outposts 控制平面操作清單，請參閱適用於管理儲存貯體的 Amazon S3 Control API 操作。

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