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

# 針對您的 S3 on Outposts 儲存貯體存取點使用儲存貯體樣式別名
<a name="s3-outposts-access-points-alias"></a>

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

下列範例顯示了名稱為 `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)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。

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

**Topics**
+ [存取點別名](#access-points-alias-name-s3-outposts)
+ [在 S3 on Outposts 物件操作中使用存取點別名](#access-points-alias-use-case-s3-outposts)
+ [限制](#access-points-alias-limitations-s3-outposts)

## 存取點別名
<a name="access-points-alias-name-s3-outposts"></a>

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

`access point name prefix-metadata--op-s3`

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

### 尋找存取點別名
<a name="access-points-alias-name-s3-outposts-find"></a>

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

**Example ：在 Amazon S3 主控台中尋找並複製存取點別名**  
在主控台中建立存取點之後，您可以從 **Access Points** (存取點) 清單中的 **Access Point alias** (存取點別名) 欄取得存取點別名。  

**複製存取點別名**

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

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

1. 若要複製存取點別名，請執行下列其中一項動作：
   + 在 **Access Points** (存取點) 清單中，選取存取點名稱旁邊的選項按鈕，然後選擇 **Copy Access Point alias** (複製存取點別名)。
   + 選擇存取點名稱。然後，在 **Outposts access point overview** (Outposts 存取點概觀) 下，複製存取點別名。

**Example ：使用 建立存取點， 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"
}
```

**Example ：使用 取得存取點別名 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"
}
```

**Example ：使用 列出存取點以尋找存取點別名 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 物件操作中使用存取點別名
<a name="access-points-alias-use-case-s3-outposts"></a>

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

此 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": {}
}
```

## 限制
<a name="access-points-alias-limitations-s3-outposts"></a>
+ 客戶無法設定別名。
+ 存取點上的別名無法刪除、修改或停用。
+ 您無法將存取點別名用於 S3 on Outposts 控制平面操作。如需 S3 on Outposts 控制平面操作清單，請參閱[適用於管理儲存貯體的 Amazon S3 Control API 操作](S3OutpostsAPI.md#S3OutpostsAPIsBucket)。
+ 別名不能用於 AWS Identity and Access Management (IAM) 政策。