注意
注意：群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组，群组/项目 ID 保持不变。当引用说明时，此页面将使用“群组”这个更为人熟知的术语。终结点仍如文档中所述。
基本 URL： https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
语法
GET /api/public/v1.0/groups/{PROJECT-ID}/integrations请求路径参数
Parameter | 必要性 | 说明 |
|---|---|---|
| 必需 | 项目标识符。 |
请求查询参数
名称 | 类型 | 必要性 | 说明 | 默认 |
|---|---|---|---|---|
pageNum | 数字 | Optional | 从一开始的整数，用于返回结果的一部分。 |
|
itemsPerPage | 数字 | Optional | 每页要返回的项目数，最多 500 个。 |
|
pretty | 布尔 | Optional |
| |
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题，在查询中设置 对于返回结果列表的端点， |
|
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应元素
响应包括一个results数组（将项目的所有第三方集成配置列为对象）以及与项目集成的服务的totalCount 。
每个第三方集成配置对象都包含一个等于其自身集成类型的type属性（例如 "type": "PAGER_DUTY" （对于 PagerDuty 服务）。 此外，每个第三方服务配置对象都提供特定于该服务的详细信息。 下面列出了为每个第三方服务配置对象返回的属性：
PagerDuty
返回的 PagerDuty 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的服务密钥。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
Slack
返回的 Slack 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 API 令牌。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
| 你的团队名称。 旧版 Slack 集成中可能不存在此字段。 |
| 配置的 Slack 渠道名称。如果未设置该值，则为空字符串。 |
Datadog
返回的 Datadog 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 API 密钥。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
HipChat
返回的 HipChat 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| HipChat 用户帐户的通知令牌。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
| 您的 HipChat 房间名称。 |
Opsgenie
返回的 Opsgenie 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 API 密钥。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
| 指示要使用哪个 `API URL`， |
要将 region 设置为 EU，必须设置 自定义设置 的 opsgenie.api.url。
VictorOps
返回的 VictorOps 集成配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 API 密钥。 创建需要 API 或集成密钥的第三方集成后，当您执行以下操作时，该密钥将显示为部分经过校订的：
|
| 有条件。仅在配置了路由密钥的情况下返回。 |
Webhook 设置
返回的 Webhook 配置对象包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 Webhook URL。 创建 Webhook 通知后，当您查看或编辑警报时， URL将被部分编辑，并且密钥将被完全编辑。 |
| 有条件。仅当您的 Webhook 配置了密钥时才返回。 |
| Ops Manager 用于获取 Webhook 通知持有者访问令牌的 OAuth 2.0 客户端凭证。仅当您的 Webhook 配置了 OAuth 2.0 客户端凭证时才会返回。 |
| MongoDB Ops Manager 调用以获取持有者访问令牌的令牌终结点。 |
| Ops Manager 在向 OAuth 2.0 令牌终结点进行身份验证时使用的客户端标识符。 |
| Ops Manager 在向 OAuth 2.0 令牌终结点进行身份验证时，与客户端 ID 一起使用的客户端密码。 |
Microsoft Teams
返回的 Microsoft 团队 配置对象将包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 Microsoft 团队 传入 Webhook URL。 当您查看或编辑 Webhook 通知的警报时，URL 会显示为部分遮蔽，而密钥显示为完全遮蔽。 |
Prometheus
返回的 Prometheus 配置对象将包含以下字段：
属性 | 说明 |
|---|---|
|
|
| 您的 Prometheus 用户名。 |
| Prometheus 实例将连接的 IP 地址和端口。 |
| 指示使用哪种服务发现方法，为 |
| 为请求配置的 Prometheus 协议模式，可以是 |
| 您的集群是否启用了 Prometheus。 |
| 有条件。仅在您的 PEM 文件有密码的情况下返回。 |
| 有条件。仅在您有 PEM 文件的绝对路径时返回。 |
请求示例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/integrations"响应示例
{ "links": [ { "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/integrations?pageNum=1&itemsPerPage=100", "rel": "self" } ], "results": [ { "serviceKey": "******7890", "type": "PAGER_DUTY" }, { "apiToken": "******7890", "channelName": "My Channel", "teamName": "My Team", "type": "SLACK" }, ], "totalCount": 2 }