

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

# Amazon 中的 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 客户凭证  
OAuth 当返回 401 或 407 响应时，令牌会被刷新

**需要的其他授权参数：**  
思科 AppDynamics 客户端 ID 和客户端密钥  
OAuth 端点：  
`https://{{tenantName}}.observe.appdynamics.com/auth/{{tenantId}}/default/oauth2/token`  
以下 OAuth 键/值对参数：      
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/eventbridge/latest/userguide/eb-api-destination-partners.html)

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

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

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

## 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 文档中的 [Find the REST endpoint address and cluster 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/log-query-simply-retrieve-data/)。

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

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

**Coralogix 文档**  
[Amazon EventBridge 身份验证](https://coralogix.com/docs/amazon-eventbridge/)

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

**其他信息**  
这些事件存储为日志条目，`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/事件  
POST https://http-intake.logs.datadoghq.com/v1/ 输入

**其他信息**  
终端节点 URLs 因您的 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/ingest
+ 戴维斯赛事：https://{{environment-id}}.live.dynatrace。 com/platform/ingest/v1/events
+ SDLC 活动：https://{{environment-id}}.live.dynatrace。 com/platform/ingest/v1/events.sdlc
+ 安全事件：https://{{environment-id}}.live.dynatrace。 com/platform/ingest/v1/events. 安全

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

**需要的其他授权参数：**      
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/eventbridge/latest/userguide/eb-api-destination-partners.html)

**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

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

## Freshworks
<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}}/endpoint/

**支持的授权类型**   
API 密钥  
电子邮件/密码  
自定义 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 密钥

**需要的其他授权参数：**      
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Momento 文档：**  
[Momento \+ Amazon EventBridge](https://docs.momentohq.com/cache/integrations/amazon-eventbridge)  
[Using the Momento Topics API](https://docs.momentohq.com/topics/develop/api-reference)  
[API reference for Momento Cache](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/ 账户//活动 {{YOUR\_NEW\_RELIC\_ACCOUNT\_ID}}  
**欧盟—** https://insights-collector.eu01.nr-data。 net/v1/accounts/{{YOUR\_NEW\_RELIC\_ACCOUNT\_ID}}/events  
**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-记录

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

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

**Operata 文档：**  
[如何创建、查看、更改和撤销 API 令牌？](https://help.operata.com/en/articles/5542797-how-do-i-create-view-change-and-revoke-api-tokens)  
[使用 Amazon 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**  
**Sobject— https://{{myDomainName}}.my.salesforc** e。 com/services/data/{{versionNumber}}/sobjects //\* {{SobjectEndpoint}}  
**自定义平台事件—** https://{{myDomainName}}.my.salesforce。 com/services/data//sobject {{versionNumber}} s/ /\* {{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/token
+ **没有增强域名的沙箱 — https://{{MyDomainName}}—** {{ SandboxName}} .my. salesforce。 com/services /oauth2/token
+ **带有增强域名的沙箱 — https://{{MyDomainName}}—** {{ SandboxName}} .sandbox.my.salesforce。 com/services/oauth2/token
以下 key/value 一对：      
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/eventbridge/latest/userguide/eb-api-destination-partners.html)

**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.postMess

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

## Shopify
<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  
删除-admin/api/2022-01/products/{product\_id} .json

**其他信息**  
[创建应用](https://shopify.dev/apps/getting-started/create)  
[亚马逊 EventBridge webhook 配送](https://shopify.dev/apps/webhooks/configuration/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。  
基本（用户名/密码）— 为配置终端节点时 EventBridge，用户名为 “Splunk”，密码为 Splunk HEC 令牌 ID。

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

**API 目标调用端点 URL**  
每个用户的 HTTP 日志和指标源端点 URLs 将有所不同。有关更多信息，请参阅 [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}}

**其他信息**  
无

## TriggerMesh
<a name="eb-api-destination-triggermesh"></a>

**API 目标调用端点 URL**  
使用 [HTTP 事件源](https://docs.triggermesh.io/concepts/sources)主题中的信息来确定端点 URL。端点 URL 包括事件源名称和用户命名空间，格式如下：  
https://{{source-name}}。 {{user-namespace}}.cloud.triggermesh.io  
要在请求中包含端点的基本授权参数。

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

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

**TriggerMesh 文档**  
[HTTP 事件源](https://docs.triggermesh.io/concepts/sources)

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

**其他信息**  
无

## 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 密钥，而不是基本的登录凭证身份验证。