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

# 建立依字首、物件標籤或存取點篩選的指標組態
<a name="metrics-configurations-filter"></a>

Amazon S3 有三種類型的 Amazon CloudWatch 指標：儲存指標、請求指標和複寫指標。儲存體指標會每天回報一次，並免費提供給所有客戶。請求指標會在一些處理延遲之後，以 1 分鐘的間隔提供。請求指標會以標準 CloudWatch 費率計費。您必須在主控台中設定或透過 Amazon S3 API 來選擇使用請求指標。[S3 複寫指標](https://docs.aws.amazon.com/AmazonS3/latest/userguide/viewing-replication-metrics.html)提供了複寫組態中複寫規則的詳細指標。透過複寫指標，您可以透過追蹤擱置的位元組、擱置中的操作、複寫失敗的操作和複寫延遲來監控每分鐘進度。

如需有關 Amazon S3 的 CloudWatch 指標的詳細資訊，請參閱「[使用 Amazon CloudWatch 監控指標](cloudwatch-monitoring.md)」。

設定 CloudWatch 指標時，您可以建立包含儲存貯體中所有物件的篩選條件，也可以將單一儲存貯體中的相關物件作為群組篩選出來。您也可以根據下列一或多個篩選條件類型，篩選儲存貯體中要包含在指標組態中的物件：
+ **物件金鑰名稱字首** – 雖然 Amazon S3 資料模型是單層式結構，但您可以使用字首來推斷階層。Amazon S3 主控台採用資料夾的概念來支援這些前綴。如果您依字首進行篩選，可知道指標組態含有具有相同字首的物件。如需字首的詳細資訊，請參閱 [使用字首整理物件](using-prefixes.md)。
+ **標籤** – 您可以將標籤 (鍵/值名稱對) 新增至物件。標籤可讓您輕鬆尋找與整理物件。您也可以將這些標籤當做指標組態的篩選條件。如需物件標籤的詳細資訊，請參閱 [使用標籤為物件分類](object-tagging.md)。
+ **存取點** – S3 存取點為連接到儲存貯體的指定網路端點並可簡化 S3 中共用資料集的大規模資料存取管理。當您建立存取點篩選條件時，Amazon S3 包含對您在指標組態中指定的存取點的請求。如需詳細資訊，請參閱[監控與記錄存取點](access-points-monitoring-logging.md)。
**注意**  
當您建立依存取點篩選的指標組態時，必須使用存取點 Amazon Resource Name (ARN)，而不是存取點別名。確定您使用 ARN 作為存取點本身，而不是特定物件的 ARN。如需存取點 ARN 的更多資訊，請參閱 [將 Amazon S3 Access Points 用於一般用途儲存貯體](using-access-points.md)。

如果您指定篩選條件，則只有對單一物件進行操作的要求才能符合篩選條件，並包含在所要求的指標中。如果組態搭配篩選條件，則 [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) 和 `ListObjects` 之類的請求不會傳回任何指標。

若要要求更複雜的篩選，請選擇兩個或多個元素。只有具有所有這些元素的物件才會包含在指標組態中。如果您未設定篩選條件，則儲存貯體中的所有物件都會包含在指標組態中。

## 使用 S3 主控台
<a name="configure-metrics-filter"></a>

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。

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

1. 在儲存貯體清單中，選擇包含您要請求指標之物件的儲存貯體名稱。

1. 選擇 **Metrics** (指標) 標籤。

1. 在 **Bucket metrics** (儲存貯體指標) 下，選擇 **View additional charts** (檢視其他圖表)。

1. 選擇 **Request metrics** (請求指標) 標籤。

1. 選擇 **Create filter** (建立篩選條件)。

1. 在 **Filter name** (篩選條件名稱) 方塊中，輸入篩選條件的名稱。

   名稱可包含字母、數字、句點、破折號和底線。

1. 在 **Filter scope** (篩選條件範圍) 底下，選擇 **Limit the scope of this filter using a prefix, object tags, and an S3 Access Point, or a combination of all three** (使用字首、物件標籤和 S3 存取點或組合全部三者來限制此篩選條件的範圍)。

1. 在 **Filter type** (篩選條件類型) 底下，至少選擇一種篩選條件類型：**字首**、**物件標籤**或**存取點**。

1. 若要定義字首篩選條件並將篩選條件的範圍限制為單一路徑，請在 **Prefix** (字首) 方塊中，輸入字首。

1. 若要定義物件標籤篩選條件，在 **Object tags** (物件標籤) 下，選擇 **Add tag** (新增標籤)，然後輸入標籤 **Key** (金鑰) 和 **Value** (數值)。

1. 若要定義存取點篩選條件，請在 **S3 Access Point** (S3 存取點) 欄位中，輸入存取點 ARN，或選擇 **Browse S3** (瀏覽 S3) 以導覽至存取點。
**重要**  
您無法輸入存取點別名。您必須輸入 ARN 作為存取點本身，而不是特定物件的 ARN。

1. 選擇**儲存變更**。

   Amazon S3 隨即會建立使用所指定字首、標籤或存取點的篩選條件。

1. 在 **Request metrics** (請求指標) 標籤的 **Filters** (篩選條件) 底下，選擇您剛才建立的篩選條件。

   您現在已建立篩選條件，可依字首、物件標籤或存取點限制請求指標範圍。在 CloudWatch 開始追蹤這些請求指標約 15 分鐘後，Amazon S3 和 CloudWatch 主控台即會顯示這些指標的圖表。請求指標會以標準 CloudWatch 費率計費。如需詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing/)。

   您也可以在儲存貯體層級配置請求指標。如需相關資訊，請參閱[為儲存貯體中的所有物件建立 CloudWatch 指標組態](configure-request-metrics-bucket.md)。

## 使用 AWS CLI
<a name="add-metrics-configurations"></a>

1. 安裝和設定 AWS CLI。如需說明，請參閱*《AWS Command Line Interface 使用者指南》*中的[安裝、更新和解除安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。

1. 開啟終端機。

1. 若要新增指標組態，請執行下列命令：  
**Example ：若要依字首進行篩選**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
   ```  
**Example ：若要依標籤進行篩選**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
   ```  
**Example ：若要依存取點進行篩選**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
   ```  
**Example ：若要依字首、標籤和存取點進行篩選**  

   ```
   aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '
   {
       "Id": "metrics-config-id",
       "Filter": {
           "And": {
               "Prefix": "string",
               "Tags": [
                   {
                       "Key": "string",
                       "Value": "string"
                   }
               ],
               "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
           }
       }
   }'
   ```

## 使用 REST API
<a name="configure-cw-filter-rest"></a>

您也可以使用 Amazon S3 REST API，以程式設計方式新增指標組態。如需新增和使用指標組態的詳細資訊，請參閱*《Amazon Simple Storage Service API 參考》*中的下列主題：
+ [PUT 儲存貯體指標組態](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET 儲存貯體指標組態](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [List 儲存貯體指標組態](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [DELETE 儲存貯體指標組態](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)