

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

`GetMetricMetadata` 操作检索有关当前正在从目标中抓取的指标的元数据。它不提供任何目标信息。

查询结果的数据部分由一个对象组成，其中每个键是一个指标名称，每个值是唯一的元数据对象的列表，在所有目标中针对该指标名称公开。

有效的 HTTP 动词：  
`GET`

有效 URIs：  
`/workspaces/workspaceId/api/v1/metadata`

URL 查询参数：  
`limit=<number>` 要返回的最大指标数。  
`metric=<string>` 要筛选元数据的指标名称。如果将其保留为空，则会检索所有指标元数据。

**示例请求**

```
GET /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/metadata 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
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
Transfer-Encoding: chunked

{
    "status": "success",
    "data": {
        "aggregator_openapi_v2_regeneration_count": [
            {
                "type": "counter",
                "help": "[ALPHA] Counter of OpenAPI v2 spec regeneration count broken down by causing APIService name and reason.",
                "unit": ""
            }
        ],
        ...
    }
}
```