本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon S3 on Outposts 存取點
若要存取 Amazon S3 on Outposts 儲存貯體，您必須建立和設定存取點。
存取點針對 Amazon S3 中的共用資料集，簡化管理大規模的資料存取。存取點為連接到儲存貯體的指定網路端點，您可以使用這些端點來執行 Amazon S3 物件操作，例如 `GetObject` 和 `PutObject`。使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。存取點僅支援虛擬主機樣式定址。
**注意**
建立 Outposts 儲存貯體的 AWS 帳戶 擁有該儲存貯體，且是唯一可以為其指派存取點的帳戶。
下列各節說明了如何建立和管理 S3 on Outposts 儲存貯體存取點。
**Topics**
+ [建立 S3 on Outposts 存取點](S3OutpostsCreateAccessPoint.md)
+ [針對您的 S3 on Outposts 儲存貯體存取點使用儲存貯體樣式別名](s3-outposts-access-points-alias.md)
+ [檢視存取點組態的相關資訊](S3OutpostsAccessPointGet.md)
+ [檢視 Amazon S3 Outposts 存取點清單](S3OutpostsAccessPointList.md)
+ [刪除存取點](S3OutpostsAccessPointsDelete.md)
+ [新增或編輯存取點政策](S3OutpostsAccessPointEditPolicy.md)
+ [查看 S3 on Outposts 存取點政策](S3OutpostsAccessPointGetPolicy.md)
# 建立 S3 on Outposts 存取點
若要存取 Amazon S3 on Outposts 儲存貯體，您必須建立和設定存取點。
存取點針對 Amazon S3 中的共用資料集，簡化管理大規模的資料存取。存取點為連接到儲存貯體的指定網路端點，您可以使用這些端點來執行 Amazon S3 物件操作，例如 `GetObject` 和 `PutObject`。使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。存取點僅支援虛擬託管樣式定址。
下列範例示範如何使用 AWS 管理主控台、AWS Command Line Interface (AWS CLI) 和 適用於 Java 的 AWS SDK 建立 S3 on Outposts 存取點。
**注意**
建立 Outposts 儲存貯體的 AWS 帳戶 擁有該儲存貯體，且是唯一可以為其指派存取點的帳戶。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts buckets** (Outposts 儲存貯體)。
1. 選擇您要為其建立 Outposts 存取點的 Outposts 儲存貯體。
1. 選擇 **Outposts access points** (Outposts 存取點) 索引標籤。
1. 在 **Outposts access points** (Outposts 存取點) 區段中，選擇 **Create Outposts access point** (建立 Outposts 存取點)。
1. 在 **Outposts access point settings** (Outposts 存取點設定) 中，輸入存取點的名稱，然後選擇存取點的 Virtual Private Cloud (VPC)。
1. 如果您想要新增存取點的政策，可以在 **Outposts access point policy** (Outposts 存取點政策) 區段輸入政策。
如需更多詳細資訊，請參閱 [使用 S3 on Outposts 設定 IAM](S3OutpostsIAM.md)。
## 使用 AWS CLI
**Example**
下列 AWS CLI 範例建立 Outposts 儲存貯體的存取點。若要執行此命令，請以您自己的資訊取代 `user input placeholders`。
```
aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345
```
## 使用適用於 Java 的 AWS 軟體開發套件
**Example**
如需如何使用適用於 Java 的 AWS SDK 為 S3 Outposts 儲存貯體建立存取點的範例，請參閱《適用於 Java 的 AWS SDK 2.x 程式碼範例》**中的 [CreateOutpostsAccessPoint.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/s3/src/main/java/com/example/s3/outposts/CreateOutpostsAccessPoint.java)。
# 針對您的 S3 on Outposts 儲存貯體存取點使用儲存貯體樣式別名
使用 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)
## 存取點別名
存取點別名是在與 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)。
### 尋找存取點別名
下列範例向您展示如何使用 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 物件操作中使用存取點別名
採用存取點時，您可以使用存取點別名，而不需要進行大量的程式碼變更。
此 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 操作](S3OutpostsAPI.md#S3OutpostsAPIsBucket)。
+ 別名不能用於 AWS Identity and Access Management (IAM) 政策。
# 檢視存取點組態的相關資訊
存取點針對 Amazon S3 中的共用資料集，簡化管理大規模的資料存取。存取點為連接到儲存貯體的指定網路端點，您可以使用這些端點來執行 Amazon S3 物件操作，例如 `GetObject` 和 `PutObject`。使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。存取點僅支援虛擬託管樣式定址。
下列主題說明如何使用 AWS 管理主控台、 AWS Command Line Interface (AWS CLI) 和 傳回 S3 on Outposts 存取點的組態資訊 適用於 Java 的 AWS SDK。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts access points** (Outposts 存取點)。
1. 選擇您要檢視組態詳細資訊的 Outposts 存取點。
1. 在 **Outposts 存取點概觀**下，檢閱存取點的組態詳細資訊。
## 使用 AWS CLI
下列 AWS CLI 範例會取得 Outposts 儲存貯體的存取點。以您自己的資訊取代 `user input placeholders`。
```
aws s3control get-access-point --account-id 123456789012 --name arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point
```
## 使用適用於 Java 的 AWS 開發套件
下列適用於 Java 的開發套件範例取得 Outposts 儲存貯體的存取點。
```
import com.amazonaws.services.s3control.model.*;
public void getAccessPoint(String accessPointArn) {
GetAccessPointRequest reqGetAP = new GetAccessPointRequest()
.withAccountId(AccountId)
.withName(accessPointArn);
GetAccessPointResult respGetAP = s3ControlClient.getAccessPoint(reqGetAP);
System.out.printf("GetAccessPoint Response: %s%n", respGetAP.toString());
}
```
# 檢視 Amazon S3 Outposts 存取點清單
存取點針對 Amazon S3 中的共用資料集，簡化管理大規模的資料存取。存取點為連接到儲存貯體的指定網路端點，您可以使用這些端點來執行 Amazon S3 物件操作，例如 `GetObject` 和 `PutObject`。使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。存取點僅支援虛擬託管樣式定址。
下列主題說明如何使用 AWS 管理主控台、 AWS Command Line Interface (AWS CLI) 和 傳回 S3 on Outposts 存取點的清單 適用於 Java 的 AWS SDK。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts access points** (Outposts 存取點)。
1. 在 **Outposts 存取點**下，檢閱 S3 on Outposts 存取點。
## 使用 AWS CLI
下列 AWS CLI 範例列出 Outposts 儲存貯體的存取點。若要執行此命令，請以您自己的資訊取代 `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
```
## 使用適用於 Java 的 AWS 開發套件
下列適用於 Java 的開發套件範例列出了 Outposts 儲存貯體的存取點。
```
import com.amazonaws.services.s3control.model.*;
public void listAccessPoints(String bucketArn) {
ListAccessPointsRequest reqListAPs = new ListAccessPointsRequest()
.withAccountId(AccountId)
.withBucket(bucketArn);
ListAccessPointsResult respListAPs = s3ControlClient.listAccessPoints(reqListAPs);
System.out.printf("ListAccessPoints Response: %s%n", respListAPs.toString());
}
```
# 刪除存取點
存取點針對 Amazon S3 中的共用資料集，簡化管理大規模的資料存取。存取點為連接到儲存貯體的指定網路端點，您可以使用這些端點來執行 Amazon S3 物件操作，例如 `GetObject` 和 `PutObject`。使用 S3 on Outposts，您必須使用存取點來存取 Outposts 儲存貯體中的任何物件。存取點僅支援虛擬主機樣式定址。
下列範例示範如何使用 AWS 管理主控台 和 AWS Command Line Interface (AWS CLI) 刪除存取點。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts access points** (Outposts 存取點)。
1. 在 **Outposts access points** (Outposts 存取點) 區段中，選擇您要刪除的 Outposts 存取點。
1. 選擇 **Delete** (刪除)。
1. 確認刪除。
## 使用 AWS CLI
下列 AWS CLI 範例刪除 Outposts 存取點。若要執行此命令，請以您自己的資訊取代 `user input placeholders`。
```
aws s3control delete-access-point --account-id 123456789012 --name arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point
```
# 新增或編輯存取點政策
存取點有 Amazon S3 on Outposts 對於透過該存取點進行的任何請求所套用的不同許可和網路控制。每個存取點都會強制執行自訂的存取點政策，該政策可結合附加至基礎儲存貯體的儲存貯體政策運作。如需更多詳細資訊，請參閱 [存取點](S3OutpostsWorkingBuckets.md#S3OutpostsAP)。
下列主題介紹如何使用 AWS 管理主控台、AWS Command Line Interface (AWS CLI) 和 適用於 Java 的 AWS SDK 新增或編輯 S3 on Outposts 存取點政策。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts buckets** (Outposts 儲存貯體)。
1. 選擇您要編輯存取點政策的 Outposts 儲存貯體。
1. 選擇 **Outposts access points** (Outposts 存取點) 索引標籤。
1. 在 **Outposts access points** (Outposts 存取點) 區段中，選取您要編輯其政策的存取點，然後選擇 **Edit policy** (編輯政策)。
1. 在 **Outposts access point policy** (Outposts 存取點政策) 區段中新增或編輯政策。如需更多詳細資訊，請參閱 [使用 S3 on Outposts 設定 IAM](S3OutpostsIAM.md)。
## 使用 AWS CLI
下列 AWS CLI 範例將政策放置在 Outposts 存取點上。
1. 將以下存取點政策儲存至 JSON 檔案。在此範例中，檔案命名為 `appolicy1.json`。以您自己的資訊取代 `user input placeholders`。
```
{
"Version":"2012-10-17",
"Id":"exampleAccessPointPolicy",
"Statement":[
{
"Sid":"st1",
"Effect":"Allow",
"Principal":{
"AWS":"123456789012"
},
"Action":"s3-outposts:*",
"Resource":"arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point
}
]
}
```
1. 提交 JSON 檔案以做為 `put-access-point-policy` CLI 命令的一部分。以您的資訊取代 `user input placeholders`。
```
aws s3control put-access-point-policy --account-id 123456789012 --name arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point --policy file://appolicy1.json
```
## 使用適用於 Java 的 AWS 軟體開發套件
下列適用於 Java 的開發套件範例在 Outposts 存取點上放置政策。
```
import com.amazonaws.services.s3control.model.*;
public void putAccessPointPolicy(String accessPointArn) {
String policy = "{\"Version\":\"2012-10-17\",\"Id\":\"testAccessPointPolicy\",\"Statement\":[{\"Sid\":\"st1\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"" + AccountId + "\"},\"Action\":\"s3-outposts:*\",\"Resource\":\"" + accessPointArn + "\"}]}";
PutAccessPointPolicyRequest reqPutAccessPointPolicy = new PutAccessPointPolicyRequest()
.withAccountId(AccountId)
.withName(accessPointArn)
.withPolicy(policy);
PutAccessPointPolicyResult respPutAccessPointPolicy = s3ControlClient.putAccessPointPolicy(reqPutAccessPointPolicy);
System.out.printf("PutAccessPointPolicy Response: %s%n", respPutAccessPointPolicy.toString());
printWriter.printf("PutAccessPointPolicy Response: %s%n", respPutAccessPointPolicy.toString());
}
```
# 查看 S3 on Outposts 存取點政策
存取點有 Amazon S3 on Outposts 對於透過該存取點進行的任何請求所套用的不同許可和網路控制。每個存取點都會強制執行自訂的存取點政策，該政策可結合附加至基礎儲存貯體的儲存貯體政策運作。如需更多詳細資訊，請參閱 [存取點](S3OutpostsWorkingBuckets.md#S3OutpostsAP)。
如需使用 S3 on Outposts 存取點的詳細資訊，請參閱 [使用 S3 on Outposts 儲存貯體](S3OutpostsWorkingBuckets.md)。
下列主題示範如何使用 AWS 管理主控台、AWS Command Line Interface (AWS CLI) 和 適用於 Java 的 AWS SDK 檢視 S3 on Outposts 存取點政策。
## 使用 S3 主控台
1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇 **Outposts access points** (Outposts 存取點)。
1. 選擇您要編輯存取點政策的 Outposts 存取點。
1. 在**Permissions (許可)**標籤上，檢閱 S3 on Outposts 存取點政策。
1. 若要編輯存取點政策，請參閱 [新增或編輯存取點政策](S3OutpostsAccessPointEditPolicy.md)。
## 使用 AWS CLI
下列 AWS CLI 範例取得 Outposts 存取點的政策。若要執行此命令，請以您自己的資訊取代 `user input placeholders`。
```
aws s3control get-access-point-policy --account-id 123456789012 --name arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point
```
## 使用適用於 Java 的 AWS 軟體開發套件
下列適用於 Java 的開發套件範例取得 Outposts 存取點的政策。
```
import com.amazonaws.services.s3control.model.*;
public void getAccessPointPolicy(String accessPointArn) {
GetAccessPointPolicyRequest reqGetAccessPointPolicy = new GetAccessPointPolicyRequest()
.withAccountId(AccountId)
.withName(accessPointArn);
GetAccessPointPolicyResult respGetAccessPointPolicy = s3ControlClient.getAccessPointPolicy(reqGetAccessPointPolicy);
System.out.printf("GetAccessPointPolicy Response: %s%n", respGetAccessPointPolicy.toString());
printWriter.printf("GetAccessPointPolicy Response: %s%n", respGetAccessPointPolicy.toString());
}
```