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

# 使用標籤建立存取點
<a name="access-points-create-tag"></a>

您可以在建立存取點時為其加上標籤。除了標準 S3 API 請求費率之外，在存取點上使用標籤不會產生額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://docs.aws.amazon.com/s3/pricing/)。如需標記存取點的詳細資訊，請參閱 [搭配使用標籤和一般用途儲存貯體的 S3 存取點](access-points-tagging.md)。

## 許可
<a name="access-points-create-tag-permissions"></a>

若要建立具有標籤的存取點，您必須具有下列權限：
+ `s3:CreateBucket`
+ `s3:TagResource`

## 故障診斷錯誤
<a name="access-points-create-tag-troubleshooting"></a>

如果您在嘗試建立具有標籤的存取點時遇到錯誤，您可以執行下列動作：
+ 確認您擁有用於建立存取點並為其加上標籤時所需的 [許可](#access-points-create-tag-permissions)。
+ 檢查您的 IAM 使用者政策是否具備任何屬性型存取控制 (ABAC) 條件。您可能只需要使用特定的標籤鍵和值來標記存取點。如需詳細資訊，請參閱[使用屬性型存取控制 (ABAC) 的標籤](tagging.md#using-tags-for-abac)。

## 步驟
<a name="access-points-create-tag-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs 建立已套用標籤的存取點。

## 使用 S3 主控台
<a name="access-points-create-tag-console"></a>

使用 Amazon S3 主控台建立具有標籤的存取點：

1. 從 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 登入 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**存取點 (一般用途儲存貯體)**。

1. 選擇**建立存取點**以建立新存取點。

1. 在**建立存取點**頁面上，**標籤**是建立新存取點時的選項。

1. 輸入存取點的名稱。如需詳細資訊，請參閱[存取點命名規則、約束和限制](access-points-restrictions-limitations-naming-rules.md)。

1. 選擇**新增標籤**以開啟**標籤**編輯器，然後輸入標籤鍵值對。標籤鍵為必要項，但標籤是選用的。

1. 若要新增另一個標籤，請再次選擇**新增標籤**。您最多能輸入 50 個鍵值對。

1. 完成指定新存取點的選項後，請選擇**建立存取點**。

## 使用 AWS SDKs
<a name="access-points-create-tag-sdks"></a>

------
#### [ SDK for Java 2.x ]

此範例示範如何藉由使用 AWS SDK for Java 2.x建立具有標籤的存取點。若要使用此命令，請以您自己的資訊取代{{使用者輸入預留位置}}。

```
CreateAccessPointRequest createAccessPointRequest = CreateAccessPointRequest.builder()
                .accountId({{111122223333}})
                .name({{{{my-access-point}}}})
                .bucket({{{{amzn-s3-demo-bucket}}}})
                .tags(Collections.singletonList(Tag.builder().key("{{key1}}").value("{{value1}}").build()))
                .build();
 awss3Control.createAccessPoint(createAccessPointRequest);
```

------

## 使用 REST API
<a name="access-points-tag-delete-api"></a>

如需有關 Amazon S3 REST API 對於建立具有標籤的存取點的支援資訊，請參閱《Amazon Simple Storage Service API 參考》**中的以下區段：
+ [CreateAccessPoint](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html)

## 使用 AWS CLI
<a name="access-points-create-tag-cli"></a>

若要安裝 AWS CLI，請參閱《 [AWS 使用者指南》中的安裝 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。 *AWS Command Line Interface *

下列 CLI 範例示範如何使用 AWS CLI建立具有標籤的存取點。若要使用此命令，請以您自己的資訊取代{{使用者輸入預留位置}}。

**要求:**

```
aws s3control create-access-point --name {{{{my-access-point}}}} \
--bucket {{{{amzn-s3-demo-bucket}}}} \
--account-id {{111122223333}} \ --profile personal \
--tags [{Key={{key1}},Value={{value1}}},{Key={{key2}},Value={{value2}}}] \
--region {{region}}
```