

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

# Amazon EventBridge 中的 API 目的地合作夥伴
<a name="eb-api-destination-partners"></a>

使用下列 AWS 合作夥伴提供的資訊，為其服務或應用程式設定 API 目的地和連線。

## Cisco 雲端可觀測性
<a name="eb-api-destination-cisco-cloud-observability"></a>

**API 目的地調用端點網址：**  
`https://tenantName.observe.appdynamics.com/rest/awsevents/aws-eventbridge-integration/endpoint`

**支援的授權類型：**  
OAuth 用戶端憑證  
傳回 401 或 407 回應時，會重新整理 OAuth 權杖

**需要其他授權參數：**  
Cisco 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_tw/eventbridge/latest/userguide/eb-api-destination-partners.html)

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

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

**其他資訊：**  
從**合作夥伴目的地**下拉式功能表中選擇 **Cisco AppDynamics** 會預先填入必要的 OAuth 資訊，包括 API 呼叫所需的標頭和內文索引鍵/值對。  
如需詳細資訊，請參閱 *Cisco AppDynamics* 文件中的[AWS 事件擷取](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)。

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

**API 目的地調用端點網址：**  
通常採用下列格式：  
`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)。

**支援的授權類型：**  
基本

**需要其他授權參數：**  
不適用

**Confluent 文件：**  
[產生記錄](https://docs.confluent.io/cloud/current/api.html#tag/Records-(v3)/operation/produceRecord)  
[適用於 Apache Kafka 的 Confluent REST Proxy](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 目的地調用端點網址**  
如需完整的端點清單，請參閱 [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-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 目的地調用端點網址**  
如需完整的端點清單，請參閱 [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 目的地調用端點網址：**  
+ 日誌：https：//*environment-id*.live.dynatrace.com/api/v2/logs/ingest
+ Davis 事件：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.security

**支援的授權類型：**  
API 金鑰

**需要其他授權參數：**      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Dynatrace 文件：**  
+ [日誌擷取](https://docs.dynatrace.com/docs/observe-and-explore/logs/lma-log-ingestion)
+ [如何擷取資料 （事件）](https://docs.dynatrace.com/docs/platform/openpipeline/getting-started/how-to-ingestion)
+ [擷取 Amazon ECR 漏洞調查結果和掃描事件](https://docs.dynatrace.com/docs/platform-modules/application-security/security-events-ingest/ingest-aws-ecr-data)

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

**其他資訊：**  
每個端點類型都有其字符範圍，這是成功驗證的必要項目。如需詳細資訊，請參閱 Dynatrace 文件中的[擷取 APIs](https://docs.dynatrace.com/docs/platform/openpipeline/reference/api-ingestion-reference)。

## Freshworks
<a name="eb-api-destination-freshworks"></a>

**API 目的地調用端點網址**  
如需端點的清單，請參閱 [https://developers.freshworks.com/documentation/](https://developers.freshworks.com/documentation/)。

**支援的授權類型**   
基本，API 金輪

**需要其他授權參數**  
不適用

**Freshworks 文件**  
[身分驗證](https://developers.freshdesk.com/api/#authentication)

**常用的 API 操作**  
https://developers.freshdesk.com/api/\$1create\$1ticket  
https://developers.freshdesk.com/api/\$1update\$1ticket  
https://developer.freshsales.io/api/\$1create\$1lead  
https://developer.freshsales.io/api/\$1update\$1lead

**其他資訊**  
無

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

**API 目的地調用端點網址**  
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 目的地調用端點網址：**  
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_tw/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Momento 文件：**  
[Momento \$1 Amazon EventBridge](https://docs.momentohq.com/cache/integrations/amazon-eventbridge)  
[使用 Momento 主題 API](https://docs.momentohq.com/topics/develop/api-reference)  
[Momento Cache 的 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 目的地調用端點網址**  
如需詳細資訊，請參閱[我們的歐盟和美國地區資料中心](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers/)。  
**事件**  
**美國:** https://insights-collector.newrelic.com/v1/accounts/*YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*/events  
**歐盟：** https://insights-collector.eu01.nr-data.net/v1/accounts/*YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*/events  
**指標**  
**美國：** 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 目的地調用端點網址：**  
https://api.operata.io/v2/aws/events/contact-record

**支援的授權類型：**  
基本

**需要其他授權參數：**  
無

**Operata 文件：**  
[如何建立、查看、變更和撤銷 API 權杖？](https://help.operata.com/en/articles/5542797-how-do-i-create-view-change-and-revoke-api-tokens)  
[使用 Amazon EventBridge 排程器進行 Operata AWS 整合](https://docs.operata.com/docs/aws-integration)

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

**其他資訊：**  
`username` 為 Operata Group ID，密碼為您的 API 權杖。

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

**API 目的地調用端點網址**  
**主題：** https:// *myDomainName*.my.salesforce.com/services/data/*versionNumber*/sobjects /*SobjectEndpoint*/\$1  
**自訂平台事件：** https://*myDomainName*.my.salesforce.com/services/data /*versionNumber*/sobjects/*customPlatformEndpoint*/\$1  
如需完整的端點清單，請參閱 [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
下列金鑰/值對：      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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 的規則的教程，請參閱 [教學課程：Salesforce從 Amazon EventBridge 將事件傳送至](eb-tutorial-salesforce.md)。

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

**API 目的地調用端點網址**  
如需端點和其他資源的清單，請參閱[使用 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 的承載具有“通道”和“文字”鍵/值對。

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

**API 目的地調用端點網址**  
如需端點和其他資源和方法的清單，請參閱[端點和請求](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/\$1product\$1id\$1.json  
PUT - admin/api/2022-01/products/\$1product\$1id\$1.json  
DELETE - admin/api/2022-01/products/\$1product\$1id\$1.json

**其他資訊**  
[建立應用程式](https://shopify.dev/apps/getting-started/create)  
[Amazon 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 目的地調用端點網址**  
https://*SPLUNK\$1HEC\$1ENDPOINT*:*optional\$1port*/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\$1HEC\$1ENDPOINT*:*optional\$1port*/services/collector/raw

**其他資訊**  
API 金鑰：設定 EventBridge 的端點時，API 金鑰名稱為“授權”，而值為 Splunk HEC 權杖 ID。  
基本 (使用者名稱/密碼)：設定 EventBridge 的端點時，使用者名稱為“Splunk”，密碼是 Splunk HEC 權杖 ID。

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

**API 目的地調用端點網址**  
每個使用者的 HTTP 日誌和指標來源端點 URL 將不同。如需詳細資訊，請參閱 [HTTP 日誌和指標來源](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source)。

**支援的授權類型**   
Sumo Logic 不需要對其 HTTP 源進行身分驗證，因為 URL 中有一個唯一金輪。因此，您應該確保將 URL 視為機密。  
當您設定 EventBridge API 目的地時，需要授權類型。為了滿足此要求，請選取 API 金輪並為其指定“虛擬金輪”的金輪名稱和“虛擬值”的金輪值。

**需要其他授權參數**  
不適用

**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\$1ID\$1PER\$1COLLECTOR*

**其他資訊**  
無

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

**API 目的地調用端點網址**  
使用 [HTTP 事件來源](https://docs.triggermesh.io/concepts/sources)主題中的資訊來制定端點 URL。端點 URL 包含事件來源名稱和使用者命名空間，格式如下：  
https://*source-name*.*user-namespace*.cloud.triggermesh.io  
在針對端點的請求中包含基本的授權參數。

**支援的授權類型**   
基本

**需要其他授權參數**  
無

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

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

**其他資訊**  
無

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

**API 目的地調用端點網址**  
https://developer.zendesk.com/rest\$1api/docs/support/tickets

**支援的授權類型**   
基本，API 金輪

**需要其他授權參數**  
無

**Zendesk 文件**  
[安全性與驗證](https://developer.zendesk.com/rest_api/docs/support/introduction#security-and-authentication)

**常用的 API 操作**  
POST https://*your\$1Zendesk\$1subdomain*/api/v2/tickets

**其他資訊**  
API 請求 EventBridge 會計入您的 Zendesk API 限制。如需有關您的方案之 Zendesk 限制的資訊，請參閱[用量限制](https://developer.zendesk.com/rest_api/docs/support/usage_limits)。  
為了更好地保護您的帳戶和資料，我們建議您使用 API 金輪而不是基本的登錄憑證身分驗證。