Docs 菜单
Docs 主页
/
MongoDB Ops Manager
/ / / /

更新第三方服务集成的配置

在此页面上

  • 语法
  • 请求路径参数
  • 请求查询参数
  • 请求正文参数
  • 响应元素
  • 请求示例
  • 响应示例

注意

注意:群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。当引用说明时,此页面将使用“群组”这个更为人熟知的术语。端点仍如文档中所述。

基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

PUT /groups/{GROUP-ID}/integrations/{INTEGRATION-TYPE}
Parameter
必要性
说明
{PROJECT-ID}
必需
项目标识符。
{INTEGRATION-TYPE}
必需

第三方服务标识符。 接受的值为:

  • DATADOG

  • HIP_CHAT

  • PAGER_DUTY

  • SLACK

  • NEW_RELIC

  • OPS_GENIE

  • VICTOR_OPS

  • WEBHOOK

名称
类型
必要性
说明
默认
pageNum
数字
Optional
从一开始的整数,用于返回结果的一部分。
1
itemsPerPage
数字
Optional
每页要返回的项目数,最多 500 个。
100
pretty
布尔
Optional
指示响应正文是否应采用 prettyprint 格式 的标志 格式。
false
envelope
布尔
Optional

指示是否将响应包装在信封中的标志。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题,在查询中设置 envelope : true

对于返回结果列表的端点, results对象是一个信封。 Ops Manager 将status字段添加到响应正文。

false
backupJobsEnabledOnly
布尔
Optional
指示是否从响应中排除未启用备份数据库的守护进程的标志。 将其设置为false以包含将backupJobsEnabled标志设置为false的守护进程配置。
true

请求正文应该是单个第三方服务的单个集成视图(如JSON配置对象)。 如果相同type的配置已存在,则该请求将更新已更改的字段。如果相同type的配置不存在,则会添加该配置。 始终包含等于第三方服务INTEGRATION_TYPEtype属性。

服务
配置选项
PagerDuty

配置 PagerDuty 集成时,必须提供以下字段:

属性
说明
type
PAGER_DUTY
serviceKey

您的集成密钥。

重要

更改集成密钥不会更改使用此集成的任何警报。 这些警报仍使用以前的集成密钥。

删除并重新添加每个 PagerDuty 通知以使用新密钥。

PagerDuty Decommissioned 他们在 110 月的 REST API v2018 密钥。如果您有 av1 密钥,则可以继续在MongoDB Ops Manager中使用该密钥。 所有新的 PagerDuty 密钥均使用其REST API v2 ,但MongoDB Ops Manager 不支持其 v2 密钥。如果您没有 REST API v1 密钥,请使用 PagerDuty Events API v1 相反。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

Slack

重要

Slack集成现在使用 OAuth 2验证方法,并且必须通过MongoDB Atlas 第三方服务集成页面进行初始配置或从传统集成进行更新。

很快将不再支持旧版令牌。

重新配置现有 Slack 集成时,必须提供以下字段:

属性
说明
type
SLACK
apiToken

您的 API 令牌。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

teamName
你的团队名称。

您还可以包含以下字段:

属性
说明
channelName
要重新配置的渠道名称。
Datadog

配置 Datadog 集成时,必须提供以下字段:

属性
说明
type
DATADOG
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

HipChat

配置 HipChat 集成时,必须提供以下字段:

属性
说明
type
HIP_CHAT
notificationToken

HipChat 用户帐户的通知令牌。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

roomName
您的 HipChat 房间名称。
Opsgenie

配置 Opsgenie 集成时,必须提供以下字段:

属性
说明
type
OPS_GENIE
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

region
指示使用哪个 API URL,可以是USEU 。 默认情况下,Opsgenie 将使用US

要将region设置为EU ,您必须将客户设置设为opsgenie.api.url

VictorOps

配置 VictorOps 集成时,必须提供以下字段:

属性
说明
type
VICTOR_OPS
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

您还可以包含以下字段:

属性
说明
routingKey
路由键的可选字段。
Webhook 设置

配置 Webhook 设置时,必须提供以下字段:

属性
说明
type
WEBHOOK
url
您的 Webhook URL。

您还可以包含以下字段:

属性
说明
secret

Webhook 密钥的可选字段。

创建 Webhook 通知后,当您查看或编辑警报时, URL将被部分编辑,并且密钥将被完全编辑。

Microsoft Teams

配置 Microsoft Teams 集成时,必须提供以下字段:

属性
说明
type
MICROSOFT_TEAMS
microsoftTeamsWebhookUrl

您的 Microsoft 团队 传入 Webhook URL。

当您查看或编辑 Webhook 通知的警报时,URL 会显示为部分遮蔽,而密钥显示为完全遮蔽。

Prometheus

配置 Prometheus 集成时,必须提供以下字段:

属性
说明
type
PROMETHEUS
username
您的 Prometheus 用户名。
password
您的 Prometheus 密码。
listenAddress
Prometheus 实例将连接的 IP 地址和端口。
serviceDiscovery
指示使用哪种服务发现方法,为filehttp
scheme
为请求配置的 Prometheus 协议模式,可以是httphttps 。 如果配置https ,则必须指定tlsPemPath
enabled
您的集群是否启用了 Prometheus。

您还可以包含以下字段:

属性
说明
tlsPemPassword
PEM 文件密码的可选字段。
tlsPemPath
PEM 文件绝对路径的可选字段。

响应包括一个results数组(将项目的所有第三方集成配置列为对象)以及与项目集成的服务的totalCount

每个第三方集成配置对象都包含一个等于其自身集成类型的type属性(对于 PagerDuty 服务为"type": "PAGER_DUTY" )。 此外,每个第三方服务配置对象都提供特定于该服务的详细信息。 下面列出了为每个第三方服务配置对象返回的属性:

服务
结果
PagerDuty

返回的 PagerDuty 集成配置对象包含以下字段:

属性
说明
type
PAGER_DUTY
serviceKey

您的服务密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

Slack

返回的 Slack 集成配置对象包含以下字段:

属性
说明
type
SLACK
apiToken

您的 API 令牌。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

teamName
你的团队名称。 旧版 Slack 集成中可能不存在此字段。
channelName
配置的 Slack 渠道名称。如果未设置该值,则为空字符串。
Datadog

返回的 Datadog 集成配置对象包含以下字段:

属性
说明
type
DATADOG
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

HipChat

返回的 HipChat 集成配置对象包含以下字段:

属性
说明
type
HIP_CHAT
notificationToken

HipChat 用户帐户的通知令牌。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

roomName
您的 HipChat 房间名称。
Opsgenie

返回的 Opsgenie 集成配置对象包含以下字段:

属性
说明
type
OPS_GENIE
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

region
指示要使用的API URL ,可以是USEU 。 Opsgenie 默认为US

要将region设置为EU ,您必须将客户设置设为opsgenie.api.url

VictorOps

返回的 VictorOps 集成配置对象包含以下字段:

属性
说明
type
VICTOR_OPS
apiKey

您的 API 密钥。

创建需要 API 或集成密钥的第三方集成后,当您执行以下操作时,该密钥将显示为部分经过校订的:

  • 通过用户界面查看或编辑警报。

  • 通过API查询第三方集成设置。

配置对象还可能包含以下字段,具体取决于您的配置:

属性
说明
routingKey
如果您配置了路由键,则返回一个字段。
Webhook 设置

返回的 Webhook 配置对象包含以下字段:

属性
说明
type
WEBHOOK
url

您的 Webhook URL。

创建 Webhook 通知后,当您查看或编辑警报时, URL将被部分编辑,并且密钥将被完全编辑。

配置对象还可能包含以下字段,具体取决于您的配置:

属性
说明
secret
如果您的 Webhook 配置了密钥,则返回一个可选字段。
Microsoft Teams

返回的 Microsoft 团队 配置对象将包含以下字段:

属性
说明
type
MICROSOFT_TEAMS
microsoftTeamsWebhookUrl

您的 Microsoft 团队 传入 Webhook URL。

当您查看或编辑 Webhook 通知的警报时,URL 会显示为部分遮蔽,而密钥显示为完全遮蔽。

Prometheus

返回的 Prometheus 配置对象将包含以下字段:

属性
说明
type
PROMETHEUS
username
您的 Prometheus 用户名。
listenAddress
Prometheus 实例将连接的 IP 地址和端口。
serviceDiscovery
指示使用哪种服务发现方法,为filehttp
scheme
为请求配置的 Prometheus 协议模式,可以是httphttps 。 如果配置https ,则必须指定tlsPemPath
enabled
您的集群是否启用了 Prometheus。

配置对象还可能包含以下字段,具体取决于您的配置:

属性
说明
tlsPemPassword
如果您有 PEM 文件的密码,则返回一个可选字段。
tlsPemPath
如果您有 PEM 文件的绝对路径,则返回一个可选字段。
1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --include \
5 --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/integrations/SLACK" \
6 --data '
7 {
8 "type": "SLACK",
9 "apiToken": "1234567890",
10 "teamName": "My Team"
11 }'
1{
2 "links": [
3 {
4 "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/integrations/SLACK?pageNum=1&itemsPerPage=100",
5 "rel": "self"
6 }
7 ],
8 "results": [
9 {
10 "serviceKey": "******7890",
11 "type": "PAGER_DUTY"
12 },
13 {
14 "apiToken": "******7890",
15 "channelName": "My Channel",
16 "teamName": "My Team",
17 "type": "SLACK"
18 }
19 ],
20 "totalCount": 2
21 }

后退

为第三方服务集成创建配置