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

# mon-list-metrics
<a name="cli-mon-list-metrics"></a>

## Description
<a name="w2aab9c43b3"></a>

列出與 AWS 帳戶相關聯之指標的名稱、命名空間和維度。您可以使用指標名稱、命名空間或維度的任意組合來篩選指標。如果不指定篩選條件，則會傳回屬性的所有可能相符項目。

**注意**  
mon-list-metrics 命令可能需要長達 15 分鐘，才會報告經由呼叫 `mon-put-data` 所新增的新指標名稱、命名空間和維度。`mon-get-statistics` 在 5 分鐘內可提供由 `mon-put-data` 或其他方法所放置的資料點。

## 語法
<a name="w2aab9c43b5"></a>

 ****mon-list-metrics** [--dimensions "key1={{value1}},key2={{value2}}..."] [--metric-name {{value}}] [--namespace {{value}}] [Common Options] ** 

## 選項
<a name="w2aab9c43b7"></a>


| 名稱 | 描述 | 
| --- | --- | 
| -d, --dimensions `"key1=value1,key2=value2..."`  | 要擷取的指標維度。您可以用兩種方式指定維度，而且格式可以合併或互換使用：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/AmazonCloudWatch/latest/cli/cli-mon-list-metrics.html)<br />如果不指定維度，則不會篩選維度。仍然會套用任何其他已要求的篩選條件。雖然指標可能包含超過所要求指標的額外維度，但指標必須包含所有指定的維度，才會納入結果中。<br />類型：映射<br />有效值：name=value 格式的字串，其中 key 是維度的名稱，value 是維度的值。維度名稱和值必須是長度為 1 到 250 個字元的 ANSI 字串。最多允許 10 個維度。<br />預設：無<br />必要：否 | 
| `-m, --metric-name` `VALUE`  | 指標的名稱 指標名稱必須完全符合所要求的指標名稱，才會納入結果中。如果不指定指標名稱，則不會進行篩選。將會套用任何其他已要求的篩選條件。<br />類型：簡易<br />有效值：長度為 1 到 250 個字元的任何有效指標名稱。<br />預設：無<br />必要：否 | 
| `-n, --namespace` ` VALUE`  | 用於篩選指標的命名空間。如需命名空間的詳細資訊，請參閱[AWS 命名空間](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html)。<br />類型：字串<br />有效值：長度為 1 到 250 個字元的有效命名空間。<br />預設：無<br />必要：否 | 

## 常用選項
<a name="w2aab9c43b9"></a>


| 名稱 | 描述 | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | 檔案與 AWS 登入資料的位置。您可以使用環境變數 `AWS_CREDENTIAL_FILE` 來設定這個值。如果您定義環境變數或提供憑證檔案的路徑，則檔案必須存在或請求失敗。所有 CloudWatch 請求必須使用存取金鑰 ID 和私密存取金鑰簽署。<br />類型：字串<br />有效值：檔案的有效路徑，包含存取金鑰 ID 和私密存取金鑰。<br />預設：使用環境變數 `AWS_CREDENTIAL_FILE` (如果設定)。 | 
| `-C, --ec2-cert-file-path` `VALUE`  | 用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 `EC2_CERT` 來指定這個值。<br />類型：字串<br />有效值：Amazon EC2 或 所提供 PEM 檔案的有效檔案路徑 AWS Identity and Access Management。<br />預設：使用環境變數 `EC2_CERT` (如果設定)。 | 
|  `--connection-timeout` `VALUE`  | 連線逾時值 (以秒為單位)。<br />類型：整數<br />有效值：任何正數。<br />預設：30 | 
|  `--delimiter` `VALUE`  | 顯示分隔符號 (長) 結果時使用的分隔符號。<br />類型：字串<br />有效值：任何字串。<br />預設：逗號 (,) | 
|  `--headers` ``  | 如果您要顯示表格式或分隔式結果，請包含欄標題。如果顯示 XML 結果，請從服務請求傳回 HTTP 標題 (如適用）。<br />類型：標記<br />有效值：如果存在，則顯示標題。<br />預設：`--headers` 選項預設為關閉。 | 
|  `-I, --access-key-id` `VALUE`  | 將用於簽署請求的存取金鑰 ID，與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用，否則會忽略該選項。所有對 CloudWatch 的請求都必須經過簽署，否則會拒絕該請求。<br />類型：字串<br />有效值：有效的存取金鑰 ID。<br />預設：無 | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | 將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 `EC2_CERT` 搭配使用，否則會忽略該值。如果已設定環境變數的值 `EC2_PRIVATE_KEY` 且未指定此選項，則將使用該值。如果環境變數，則會忽略此選項。`AWS_CREDENTIAL_FILE`已設定，或`--aws-credentials-file`被使用。所有對 CloudWatch 的請求都必須經過簽署，否則會拒絕該請求。<br />類型：字串<br />有效值：有效 ASN.1 私有金鑰的路徑。<br />預設：無 | 
|  `--region` `VALUE`  | 該區域請求被導向。您可使用環境變數 `EC2_REGION` 來指定該值。該區域可用於建立用來呼叫 CloudWatch 的 URL，並且必須是有效的 Amazon Web Services (AWS) 區域。<br />類型：字串<br />有效值：任何 AWS 區域，例如 us-east-1。<br />預設：us-east-1，除非設定了 `EC2_REGION` 環境變數。 | 
|  `S, --secret-key` `VALUE`  | 將用於簽署請求的私密存取金鑰，與存取金鑰 ID 搭配使用。此參數必須與 `--access-key-id` 搭配使用，否則會忽略該選項。<br />類型：字串<br />有效值：您的存取金鑰 ID。<br />預設：無 | 
|  `--show-empty-fields` ``  | 使用 (nil) 作為預留位置顯示空欄位，表示未請求此資料。<br />類型：標記<br />有效值：無<br />預設：預設不會顯示空欄位。 | 
|  `--show-request` ``  | 顯示 CLI 用來呼叫 AWS的 URL。<br />類型：標記<br />有效值：無<br />預設：false | 
|  `--show-table, --show-long, --show-xml, --quiet` ``  | 指定結果的顯示方式：在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。`--show-table` 顯示以固定欄寬形式顯示資料子集；`--show-long` 顯示以字元分隔的所有傳回的值；`--show-xml` 是從服務傳回的原始值；和 `--quiet` 會抑制所有標準輸出。所有選項是互斥的，且具有優先順序 `--show-table`、`--show-long`、`--show-xml` 及 `--quiet`。<br />類型：標記<br />有效值：無<br />預設：`--show-table` | 
|  `-U, --url` `VALUE`  | 用於聯絡 CloudWatch 的 URL。您可以使用環境變數 `AWS_CLOUDWATCH_URL` 來設定這個值。這個值可與 `--region` 搭配使用，以建立預期的 URL。此選項會覆寫用於服務呼叫的 URL。<br />類型：字串<br />有效值：有效的 HTTP 或 HTTPS URL。<br />預設：使用 `AWS_CLOUDWATCH_URL` 中指定的值 (如果設定)。 | 

## Output
<a name="w2aab9c43c11"></a>

此命令會傳回一個表格，其中包含下列項目：
+ Metric Name - 連接到這個指標的指標名稱。
+ Namespace - 與這個指標相關聯的命名空間。
+ Dimensions - 與這個指標相關聯的維度名稱和值。

Amazon CloudWatch CLI 會在 stderr 上顯示錯誤。

## 範例
<a name="w2aab9c43c13"></a>

### 範例請求
<a name="w2aab9c43c13b2"></a>

此範例傳回所有指標的清單。

```
mon-list-metrics 
```

這是呼叫 'mon-list-metrics' 的輸出範例。

```
Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...
```

### 範例請求
<a name="w2aab9c43c13b4"></a>

此範例列出具有指定名稱的指標。

```
mon-list-metrics --metric-name RequestCount
```

### 範例請求
<a name="w2aab9c43c13b6"></a>

此範例列出屬於指定命名空間的指標。

```
mon-list-metrics --namespace MyService
```

### 範例請求
<a name="w2aab9c43c13b8"></a>

此範例列出具有指定名稱和值的指標。

```
mon-list-metrics --dimensions "User=SomeUser,Stack=Test"
```

## 相關主題
<a name="w2aab9c43c15"></a>

### 下載
<a name="w2aab9c43c15b2"></a>
+ [設定命令列介面](SetupCLI.md)

### 相關動作
<a name="w2aab9c43c15b4"></a>
+ [ListMetrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html)

### 相關命令
<a name="w2aab9c43c15b6"></a>
+  [mon-describe-alarms](cli-mon-describe-alarms.md)