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

# QueryMetrics
<a name="AMP-APIReference-QueryMetrics"></a>

`QueryMetrics` 作業評估在單一時間點或在一定時間範圍內的即時查詢。

有效的 HTTP 動詞：  
`GET`, `POST`

有效 URI：  
`/workspaces/{{workspaceId}}/api/v1/query` 此 URI 會在單一時間點評估即時查詢。  
`/workspaces/{{workspaceId}}/api/v1/query_range` 此 URI 會評估一段時間範圍內的即時查詢。

URL 查詢參數：  
`query=<string>` Prometheus 表達式查詢字串。用於 `query` 和 `query_range`。  
`time=<rfc3339 | unix_timestamp>` (選用) 若您在單一時間點使用 `query` 立即查詢，則評估時間戳記。  
`timeout=<duration>` (選用) 評估逾時。預設為和由 `-query.timeout` 旗標的值加上限。用於 `query` 和 `query_range`。  
`start=<rfc3339 | unix_timestamp>` 若您正在使用 `query_range` 查詢時間範圍，則開始時間戳記。  
`end=<rfc3339 | unix_timestamp>` 若您正在使用 `query_range` 查詢時間範圍，則結束時間戳記。  
`step=<duration | float>` 查詢解析度步驟寬度 (`duration` 格式或 `float` 秒數)。只有在您正在使用 `query_range` 查詢時間範圍，並在此類查詢必要時才可使用。  
`max_samples_processed_warning_threshold=<integer>` （選用） 設定已處理查詢範例 (QSP) 的警告閾值。當查詢達到此閾值時，會在 API 回應中傳回警告訊息。  
`max_samples_processed_error_threshold=<integer>>` （選用） 設定已處理查詢範例 (QSP) 的錯誤閾值。超過此閾值的查詢會因錯誤而遭到拒絕，且不會收費。用來避免查詢成本過高。

**Duration (持續時間)**

與 Prometheus 相容 API 的 `duration`，後續立即接著下列其中一個單位：
+ `ms` 毫秒
+ `s` 秒
+ `m` 分鐘
+ `h` 小時
+ `d` 天，假設一天總是 24 小時
+ `w` 週，假設一周總是 7 天
+ `y` 年，假設一年總是 365 天

**請求範例**

```
POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0
```

**回應範例**

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1634937046.322,
                    "252590622.81000024"
                ]
            }
        ]
    }
}
```