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

# 警示聯絡點 API
<a name="v13-Grafana-API-AlertingNotificationChannels"></a>

在 Grafana 13 版中，通知是透過 Grafana 的統一提醒進行管理。舊版通知管道 API (`/api/alert-notifications`端點） 已與 Grafana 第 11 版中的舊版提醒一起移除，不再可用。反之，請使用警示佈建 API 來使用*聯絡點*，這是通知管道的統一警示取代。

**注意**  
若要搭配 Amazon Managed Grafana 工作區使用 Grafana API，您必須擁有有效的服務帳戶字符。您可以在 API 請求的 `Authorization` 欄位中包含此項目。

**注意**  
列出、建立、更新或刪除聯絡點 (`GET`、`PUT`、 `POST`和 `DELETE`上的`/api/v1/provisioning/contact-points`) 的警示佈建聯絡點端點已棄用。這些端點的回應包括 `Warning`標頭和 `X-API-Deprecation-Date`標頭，其日期為 `2026-04-07`。本主題會`GET /api/v1/provisioning/contact-points/export`完整記錄*未*取代的端點，`GET /api/alert-notifiers`以及已取代的端點，並列出僅供參考。

## 列出聯絡點類型
<a name="v13-Grafana-API-AlertNotificationChannels-notifiers"></a>

傳回 Amazon Managed Grafana 工作區中可用的聯絡點類型 （標註器） 清單。使用此端點來探索您可以設定的聯絡點類型，以及每種類型支援的選項。

```
GET /api/alert-notifiers
```

**查詢參數**
+ `version` – （選用） 將 設定為 `2`，以傳回每個聯絡點類型的完整整合類型結構描述。省略時，端點會傳回預設的聯絡點類型清單。

**範例請求**

```
GET /api/alert-notifiers HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer 1234abcd567exampleToken890
```

**回應**

回應是 JSON 陣列，其中每個元素都會描述可用的聯絡點類型。每個元素都包含類型識別符 (`type`)`name`、顯示 `description`、 和 `options` 類型支援的組態。

## 匯出聯絡點
<a name="v13-Grafana-API-AlertNotificationChannels-export"></a>

以您可以用來將警示佈建為程式碼的格式傳回 Amazon Managed Grafana 工作區中定義的聯絡點。此端點不會被取代。

```
GET /api/v1/provisioning/contact-points/export
```

**查詢參數**
+ `name` – （選用） 依聯絡點名稱篩選匯出的聯絡點。
+ `decrypt` – （選用） 是否要解密並在匯出中包含安全設定。預設為 `false`。
+ `format` – （選用） 匯出的輸出格式，例如 `json`、 `yaml`或 `hcl`(Terraform)。

**範例請求**

```
GET /api/v1/provisioning/contact-points/export?format=yaml HTTP/1.1
Accept: application/json
Authorization: Bearer 1234abcd567exampleToken890
```

**回應**

以請求的格式傳回聯絡點，適用於檔案佈建或 Terraform。根據預設，除非您將 `decrypt`設定為 ，否則會編輯安全設定`true`。

## 已取代的聯絡點端點
<a name="v13-Grafana-API-AlertNotificationChannels-deprecated"></a>

下列提醒佈建端點會管理聯絡點，但已棄用。回應包含 `Warning` 標頭和日期為 的 `X-API-Deprecation-Date`標頭`2026-04-07`。它們列於此處，僅供參考，並可能在未來版本中移除。
+ `GET /api/v1/provisioning/contact-points` – 傳回所有聯絡點。接受選用的`name`查詢參數，以依聯絡點名稱篩選。
+ `POST /api/v1/provisioning/contact-points` – 建立聯絡點。
+ `PUT /api/v1/provisioning/contact-points/{UID}` – 使用指定的 更新聯絡點`UID`。
+ `DELETE /api/v1/provisioning/contact-points/{UID}` – 刪除具有指定 的聯絡點`UID`。

這些端點使用的聯絡點物件包含下列欄位。
+ `uid` – （選用） 使用者定義的聯絡點唯一識別符。
+ `name` – （必要） 聯絡點名稱。共用名稱的聯絡點會分組在一起。
+ `type` – （必要） 聯絡點類型，例如 `email`、 `slack`或 `webhook`。
+ `settings` – （必要） 類型特定的物件，可保留聯絡點的組態。
+ `disableResolveMessage` – （選用） 是否隱藏警示解析時傳送的通知。
+ `provenance` – （唯讀） 指出如何佈建聯絡點。