

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

# 亚马逊的 API 目的地合作伙伴 EventBridge
<a name="eb-api-destination-partners"></a>

使用以下 AWS 合作伙伴提供的信息为其服务或应用程序配置 API 目标和连接。

## Cisco Cloud Observability
<a name="eb-api-destination-cisco-cloud-observability"></a>

**API 目标调用端点 URL：**  
`https://{{tenantName}}.observe.appdynamics.com/rest/awsevents/aws-eventbridge-integration/endpoint`

**支持的授权类型：**  
OAuth 客户端凭证  
当返回 401 或 407 响应时，会刷新 OAUTH 令牌。

**需要的其他授权参数：**  
思科 AppDynamics 客户端 ID 和客户端密钥  
OAuth 端点：  
`https://{{tenantName}}.observe.appdynamics.com/auth/{{tenantId}}/default/oauth2/token`  
以下 OAuth key/value 配对参数：  


<table>
<thead>
  <tr><th>类型</th><th>键</th><th>值</th></tr>
</thead>
<tbody>
  <tr><td>正文字段</td><td><code>grant_type</code></td><td><code>client_credentials</code></td></tr>
  <tr><td>标题</td><td><code>Content-Type</code></td><td><code>application/x-www-form-urlencoded; charset=utf-8</code></td></tr>
</tbody>
</table>


**思科 AppDynamics 文档：**  
[AWS 事件摄取 ](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)

**常用的 API 操作：**  
不适用

**其他信息：**  
 AppDynamics**从 “**合作伙伴目的地” ** 下拉菜单中选择 ** Cisco 会预先填入必要的 OAuth 信息，包括 API 调用所需的标题和正文 key/value 对。  
有关更多信息，请参阅 * Cisco AppDynamics * 文档[中的](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)AWS 事件提取。

## Confluent
<a name="api-destination-confluent"></a>

**API 目标调用端点 URL：**  
通常采用以下格式：  
`https://{{random-id}}.{{region}}.aws.confluent.cloud:443/kafka/v3/clusters/{{cluster-id}}/topics/{{topic-name}}/records`  
有关更多信息，请参阅Confluent文档中的[查找 REST 终端节点地址和集群 ID ](https://docs.confluent.io/cloud/current/kafka-rest/krest-qs.html#step-1-find-the-rest-endpoint-address-and-cluster-id)。

**支持的授权类型：**  
Basic

**需要的其他授权参数：**  
不适用

**Confluent 文档：**  
[Produce Records](https://docs.confluent.io/cloud/current/api.html#tag/Records-(v3)/operation/produceRecord)  
[Confluent REST Proxy for Apache Kafka](https://docs.confluent.io/platform/current/kafka-rest/api.html#records-v3)

**常用的 API 操作：**  
`POST`

**其他信息：**  
要将事件数据转换为端点可以处理的消息，请创建目标[输入转换器](eb-transform-target-input.md)。  
+ 要在不指定 Kafka 分区键的情况下生成记录，请对输入转换器使用以下模板。不需要使用输入路径。

  ```
  {
    "value":{
        "type":"JSON",
        "data":{{aws.events.event.json}}
    },
  }
  ```
+ 要使用事件数据字段作为 Kafka 分区键生成记录，请按照下面的输入路径和模板示例进行操作。此示例定义了 `orderId` 字段的输入路径，然后将该字段指定为分区键。

  首先，定义事件数据字段的输入路径：

  ```
  {
    "orderId":"$.detail.orderId"
  }
  ```

  然后，使用输入转换器模板将数据字段指定为分区键：

  ```
  {
    "value":{
      "type":"JSON",
      "data":{{aws.events.event.json}}
    },
    "key":{
      "data":"<{{orderId}}>",
      "type":"STRING"
    }
  }
  ```

## Coralogix
<a name="eb-api-destination-coralogix"></a>

**API 目标调用端点 URL**  
有关端点的完整列表，请参阅 [Coralogix API 参考](https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/aws-eventbridge-outbound-webhook/)。

**支持的授权类型**   
API 密钥

**需要的其他授权参数**  
标头 `"x-amz-event-bridge-access-key"`，值为 Coralogix API 密钥

**Coralogix 文档**  
[亚马逊 EventBridge认证 ](https://coralogix.com/docs/amazon-eventbridge/)

**常用的 API 操作**  
美国：https://ingress.coralogix.us/aws/event-bridge  
新加坡：https://ingress.coralogixsg.com/aws/event-bridge  
爱尔兰：https://ingress.coralogix.com/aws/event-bridge  
斯德哥尔摩：https://ingress.eu2.coralogix.com/aws/event-bridge  
印度：https://ingress.coralogix.in/aws/event-bridge

**其他信息**  
这些事件存储为日志条目，`applicationName=[AWS Account]`、`subsystemName=[event.source]`。

## Datadog
<a name="eb-api-destination-datadog"></a>

**API 目标调用端点 URL**  
有关端点的完整列表，请参阅 [Datadog API 参考](https://docs.datadoghq.com/api/latest/)。

**支持的授权类型**   
API 密钥

**需要的其他授权参数**  
无

**Datadog 文档**  
[身份验证](https://docs.datadoghq.com/api/latest/authentication/)

**常用的 API 操作**  
`POST` https://api.datadoghq.com/api/v1/events  
`POST` https://http-intake.logs.datadoghq.com/v1/input

**其他信息**  
端点 URL 因您的 Datadog 组织所在的位置而异。如需了解您的组织的正确 URL，请参阅[文档](https://docs.datadoghq.com/api/latest/)。

## Dynatrace
<a name="api-destination-dynatrace"></a>

**API 目标调用端点 URL：**  
+ 日志：https://{{environment-id}}.live.dynatrace。com/api/v2/logs/收录
+ 戴维斯活动：https://{{environment-id}}.live.dynatrace。com/platform/ingest/v1/活动
+ SDLC 活动：https://{{environment-id}}.live.dynatrace。com/platform/ingest/v1/events.sdlc
+ 安全事件：https://{{environment-id}}.live.dynatrace。com/platform/ingest/v1/events.security

**支持的授权类型：**  
API 密钥

**需要的其他授权参数：**  


<table>
<thead>
  <tr><th>类型</th><th>键</th><th>值</th></tr>
</thead>
<tbody>
  <tr><td>标题</td><td><code>Authorization</code></td><td>Api-Token {{DYNATRACE_API_KEY}}</td></tr>
</tbody>
</table>


**Dynatrace 文档：**  
+ [Log ingestion](https://docs.dynatrace.com/docs/observe-and-explore/logs/lma-log-ingestion)
+ [How to ingest data (events)](https://docs.dynatrace.com/docs/platform/openpipeline/getting-started/how-to-ingestion)
+ [Ingest Amazon ECR vulnerability findings and scan events](https://docs.dynatrace.com/docs/platform-modules/application-security/security-events-ingest/ingest-aws-ecr-data)

**常用的 API 操作：**  
`POST`

**其他信息：**  
每种端点类型都有其令牌作用域，这是成功进行身份验证的必要项。有关更多信息，请参阅 Dynatrace 文档中的 [Ingestion APIs](https://docs.dynatrace.com/docs/platform/openpipeline/reference/api-ingestion-reference)。

## 新鲜的作品
<a name="eb-api-destination-freshworks"></a>

**API 目标调用端点 URL**  
有关终端节点的列表，请参阅 [ https://developers.freshworks.com/documentation/ ](https://developers.freshworks.com/documentation/)

**支持的授权类型**   
基本、API 密钥

**需要的其他授权参数**  
不适用

**Freshworks 文档**  
[身份验证](https://developers.freshdesk.com/api/#authentication)

**常用的 API 操作**  
https://developers.freshdesk.com/api/\#create\_ticket  
https://developers.freshdesk.com/api/\#update\_ticket  
https://developer.freshsales.io/api/\#create\_lead  
https://developer.freshsales.io/api/\#update\_lead

**其他信息**  
无

## MongoDB
<a name="eb-api-destination-mongodb"></a>

**API 目标调用端点 URL**  
https://data.mongodb-api.com/app/{{App ID}}/终端节点/

**支持的授权类型**   
API 密钥  
Email/Password  
自定义 JWT 身份验证

**需要的其他授权参数**  
无

**MongoDB 文档**  
[Atlas 数据 API](https://www.mongodb.com/docs/atlas/app-services/data-api/)  
[端点](https://www.mongodb.com/docs/atlas/app-services/data-api/generated-endpoints/#endpoints)  
[自定义 HTTPS 端点](https://www.mongodb.com/docs/atlas/app-services/data-api/custom-endpoints/)  
[身份验证](https://www.mongodb.com/docs/atlas/app-services/data-api/generated-endpoints/#authentication)

**常用的 API 操作**  
无

**其他信息**  
无

## Momento
<a name="api-destination-momento"></a>

**API 目标调用端点 URL：**  
https://api.cache.{{region}}.prod.a.momentoHQ。com/cache/{{cacheName}}  
https://api.cache.{{region}}.prod.a.momentoHQ。com/topics/{{cacheName}}/{{topicName}}

**支持的授权类型：**  
API 密钥

**需要的其他授权参数：**  


<table>
<thead>
  <tr><th>类型</th><th>键</th><th>值</th></tr>
</thead>
<tbody>
  <tr><td>标题</td><td><code>Authorization</code></td><td>{{MOMENTO_API_KEY}}</td></tr>
</tbody>
</table>


**Momento 文档：**  
[Momento\+ 亚马逊 EventBridge ](https://docs.momentohq.com/cache/integrations/amazon-eventbridge)  
[使用Momento主题 API ](https://docs.momentohq.com/topics/develop/api-reference)  
[Momento缓存的 API 参考 ](https://docs.momentohq.com/cache/develop/api-reference)

**常用的 API 操作：**  
对于缓存：`PUT`、`DELETE`  
对于主题：`POST`

**其他信息：**  
更新或删除缓存时，请在规则目标的配置中加入以下查询字符串参数：  
+ 你要在Momento缓存中更新的密钥
+ 缓存项目的 Time-To-Live (TTL)
例如，如果输入事件包含一个使用以下值的 `details` 字段：  
`key: $.details.key ttl_seconds: $.details.ttl_seconds`

## New Relic
<a name="api-destination-new-relic"></a>

**API 目标调用端点 URL**  
有关更多信息，请参阅[我们的欧洲和美国地区数据中心](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers/)。  
**Events**  
**美国— ** https://insights-collector.newrelic.com/v1/accounts/ {{YOUR\_NEW\_RELIC\_ACCOUNT\_ID}} /活动  
**欧盟— ** https://insights-collector.eu01.nr-data.net/v1/accounts/ {{YOUR\_NEW\_RELIC\_ACCOUNT\_ID}} /活动  
**Metrics**  
**美国— ** https://metric-api.newrelic.com/metric/v1  
**欧盟— ** https://metric-api.eu.newrelic.com/metric/v1  
**日志**  
**美国— ** https://log-api.newrelic.com/log/v1  
**欧盟— ** https://log-api.eu.newrelic.com/log/v1  
**跟踪**  
**美国— ** https://trace-api.newrelic.com/trace/v1  
**欧盟— ** https://trace-api.eu.newrelic.com/trace/v1

**支持的授权类型**   
API 密钥

**New Relic 文档**  
[指标 API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/report-metrics-metric-api/)  
[事件 API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/)  
[日志 API](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/)  
[跟踪 API](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/introduction-trace-api/)

**常用的 API 操作**  
[指标 API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/report-metrics-metric-api/)  
[事件 API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/)  
[日志 API](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/)  
[跟踪 API](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/introduction-trace-api/)

**其他信息**  
[指标 API 限制](https://docs.newrelic.com/docs/telemetry-data-platform/get-data/apis/metric-api-limits-restricted-attributes/)  
[事件 API 限制](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/#limits)  
[日志 API 限制](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/#limits)  
[跟踪 API 限制](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/trace-api-general-requirements-limits/)

## Operata
<a name="api-destination-operata"></a>

**API 目标调用端点 URL：**  
https://api.operata.io/v2/aws/events/contact-record

**支持的授权类型：**  
Basic

**需要的其他授权参数：**  
无

**Operata 文档：**  
[如何创建、查看、更改和撤销 API 令牌？](https://help.operata.com/en/articles/5542797-how-do-i-create-view-change-and-revoke-api-tokens)  
[使用亚马逊 EventBridge 调度器管道进行操作 AWS 集成 ](https://docs.operata.com/docs/aws-integration)

**常用的 API 操作：**  
`POST https://api.operata.io/v2/aws/events/contact-record`

**其他信息：**  
`username` 是 Operata 群组 ID，密码是您的 API 令牌。

## Salesforce
<a name="api-destination-salesforce"></a>

**API 目标调用端点 URL**  
**主题— ** https://{{myDomainName}}.my.salesforce。com/services/data/ /sobjects/{{versionNumber}}/\* {{SobjectEndpoint}}  
**自定义平台事件— ** https://{{myDomainName}}.my.salesforce。com/services/data//sobjects/ {{versionNumber}} /\* {{customPlatformEndpoint}}  
有关端点的完整列表，请参阅 [Salesforce API 参考](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_list.htm)

**支持的授权类型**   
OAuth 客户端凭证  
当返回 401 或 407 响应时，会刷新 OAUTH 令牌。

**需要的其他授权参数**  
[Salesforce 连接的应用程序](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_oauth_and_connected_apps.htm)客户端 ID 和客户端密钥。  
以下授权端点之一：  
+ **制作— ** https://{{MyDomainName}}.my.salesforce.com。/services/oauth2/代币
+ **没有增强域名的沙箱— ** https://{{MyDomainName}}--{{ SandboxName}} .my. salesforce。com/services/oauth2/token
+ **带有增强域名的沙箱— ** https://— .sandbox {{ SandboxName}} .my.s {{MyDomainName}} alesforce。com/services/oauth2/token
以下 key/value 对：  


<table>
<thead>
  <tr><th><b>键</b></th><th><b>值</b></th></tr>
</thead>
<tbody>
  <tr><td><code>grant_type</code></td><td><code>client_credentials</code></td></tr>
</tbody>
</table>


**Salesforce 文档**  
[REST API 开发人员指南](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_what_is_rest_api.htm)

**常用的 API 操作**  
[使用对象元数据](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/using_resources_working_with_object_metadata.htm)  
[使用记录](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/using_resources_working_with_records.htm)

**其他信息**  
有关解释如何使用 EventBridge 控制台创建与的连接Salesforce、API 目标以及将信息路由到的规则的教程Salesforce，请参阅[教程：从 Amazon EventBridge 向 Salesforce 发送事件](eb-tutorial-salesforce.md)。

## Slack
<a name="eb-api-destination-slack"></a>

**API 目标调用端点 URL**  
有关端点和其他资源的列表，请参阅[使用 Slack Web API](https://api.slack.com/web)

**支持的授权类型**   
OAuth 2.0  
当返回 401 或 407 响应时，会刷新 OAUTH 令牌。  
当您创建 Slack 应用程序并将其安装到工作区时，将代表您创建一个 OAuth 持有者令牌，用于通过您的 API 目标连接对调用进行身份验证。

**需要的其他授权参数**  
不适用

**Slack 文档**  
[基本应用设置](https://api.slack.com/authentication/basics)  
[使用 OAuth 进行安装](https://api.slack.com/authentication/oauth-v2)  
[检索消息](https://api.slack.com/messaging/retrieving)  
[发送消息](https://api.slack.com/messaging/sending)  
[使用传入 Webhook 发送消息](https://api.slack.com/messaging/webhooks)

**常用的 API 操作**  
https://slack.com/api/chat.postMessage

**其他信息**  
配置 EventBridge 规则时，需要重点介绍两种配置：  
+ 包括一个标头参数，将内容类型定义为 “application/json; charset=utf-8”。
+ 使用输入转换器将输入事件映射到 Slack API 的预期输出，即确保发送到 Slack API 的负载具有 “通道” 和 “文本” key/value 对。

## Shopif
<a name="eb-api-destination-shopify"></a>

**API 目标调用端点 URL**  
有关端点列表以及其他资源和方法，请参阅[端点和请求](https://shopify.dev/api/admin-rest#endpoints)

**支持的授权类型**   
OAuth、API 密钥  
当返回 401 或 407 响应时，会刷新 OAUTH 令牌。

**需要的其他授权参数**  
不适用

**Shopify 文档**  
[身份验证和授权概述](https://shopify.dev/apps/auth)

**常用的 API 操作**  
`POST`-/admin/api/2022 01/products-.json  
`GET`- admin/api /2022-01/products/{product\_id} .json  
`PUT`- admin/api /2022-01/products/{product\_id} .json  
`DELETE`- admin/api /2022-01/products/{product\_id} .json

**其他信息**  
[创建应用](https://shopify.dev/apps/getting-started/create)  
[亚马逊 EventBridge webhook 配送 ](https://shopify.dev/docs/apps/build/webhooks/get-started?framework=remix&deliveryMethod=eventBridge)  
[以 Shopify 管理员身份使用自定义应用的访问令牌](https://shopify.dev/apps/auth/admin-app-access-tokens)  
[产品](https://shopify.dev/api/admin-rest/2021-10/resources/product#top)  
[Shopify 管理员 API](https://shopify.dev/api/admin)

## Splunk
<a name="api-destination-splunk"></a>

**API 目标调用端点 URL**  
https://{{SPLUNK\_HEC\_ENDPOINT}}:{{optional\_port}}/services/collector/raw

**支持的授权类型**   
基本、API 密钥

**需要的其他授权参数**  
无

**Splunk 文档**  
对于这两种授权类型，都需要 HEC 令牌 ID。有关更多信息，请参阅[在 Splunk Web 中设置和使用 HTTP 事件收集器](https://help.splunk.com/en/data-management/collect-http-event-data/use-hec-in-splunk-cloud-platform/set-up-and-use-http-event-collector-in-splunk-web)。

**常用的 API 操作**  
`POST`https://{{SPLUNK\_HEC\_ENDPOINT}}:{{optional\_port}}/services/collector/raw

**其他信息**  
API 密钥 — 为配置端点时 EventBridge，API 密钥名称为 “授权”，值为 Splunk HEC 令牌 ID。  
基本 (Username/Password) — 为配置端点时 EventBridge，用户名为 “Splunk”，密码是 Splunk HEC 令牌 ID。

## Sumo Logic
<a name="api-destination-sumologic"></a>

**API 目标调用端点 URL**  
每名用户的 HTTP 日志和指标源端点 URL 会有所不同。有关更多信息，请参阅 [HTTP 日志和指标源](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source)。

**支持的授权类型**   
Sumo Logic 不需要对他们的 HTTP 源进行身份验证，因为 URL 中内置了唯一的密钥。因此，您应确保将此 URL 视为机密。  
配置 EventBridge API 目标时，需要授权类型。要满足此要求，请选择 API 密钥并为其指定密钥名称“dummy-key”和密钥值“dummy-value”。

**需要的其他授权参数**  
不适用

**Sumo Logic 文档**  
Sumo Logic已经建立了托管资源来收集来自许多 AWS 服务的日志和指标，您可以使用他们网站上的信息来处理这些来源。有关更多信息，请参阅 [Amazon Web Services](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services)。  
如果您正在从应用程序生成自定义事件并希望将其Sumo Logic作为日志或指标发送到，请使用 EventBridge API 目标以及 Sumo Logic HTTP 日志和指标源端点。  
+ 要注册并创建免费 Sumo Logic 实例，请参阅[立即开始免费试用](https://www.sumologic.com/sign-up/)。
+ 有关使用 Sumo Logic 的更多信息，请参阅 [HTTP 日志和指标源](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source)。

**常用的 API 操作**  
`POST` https://endpoint4.collection.us2.sumologic.com/receiver/v1/http/{{UNIQUE\_ID\_PER\_COLLECTOR}}

**其他信息**  
无

## Zendesk
<a name="eb-api-destination-zendesk"></a>

**API 目标调用端点 URL**  
https://developer.zendesk.com/rest\_api/docs/support/tickets

**支持的授权类型**   
基本、API 密钥

**需要的其他授权参数**  
无

**Zendesk 文档**  
[安全和认证](https://developer.zendesk.com/rest_api/docs/support/introduction#security-and-authentication)

**常用的 API 操作**  
`POST`https:/{{your\_Zendesk\_subdomain}}/api/v2/tickets

**其他信息**  
API 请求计 EventBridge 入您的 Zendesk API 限制。有关您的计划的 Zendesk 限制信息，请参阅[使用限制](https://developer.zendesk.com/rest_api/docs/support/usage_limits)。  
为了更好地保护您的账户和数据，我们建议使用 API 密钥，而不是基本的登录凭证身份验证。