翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon EventBridge の API 送信先パートナー
以下の AWS パートナーから提供された情報を使用して、サービスまたはアプリケーションの API 送信先と接続を設定します。
## Cisco Cloud オブザーバビリティ
**API 送信先の呼び出しエンドポイント URL:**
`https://tenantName.observe.appdynamics.com/rest/awsevents/aws-eventbridge-integration/endpoint`
**サポートされている認可タイプ:**
OAuth クライアントの認証情報
OAuth トークンは、401 または 407 の応答が返されたときに更新されます。
**必要な追加の認可パラメータ:**
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/ja_jp/eventbridge/latest/userguide/eb-api-destination-partners.html)
**Cisco AppDynamics ドキュメント:**
[AWS イベントの取り込み](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)
**一般的に使用される API オペレーション:**
該当しない
**追加情報:**
**[パートナーの送信先]** ドロップダウンメニューから **[Cisco AppDynamics]** を選択すると、API コールに必要なヘッダーと本文のキーと値のペアなど、必要な OAuth 情報が事前入力されます。
詳細については、「*Cisco AppDynamics* ドキュメント」の「[AWS Events Ingestion](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)」を参照してください。
## Confluent
**API 送信先の呼び出しエンドポイント URL:**
通常、次の形式です。
`https://random-id.region.aws.confluent.cloud:443/kafka/v3/clusters/cluster-id/topics/topic-name/records`
詳細については、「Confluent Documentation」の「[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 Documentation:**
[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":"",
"type":"STRING"
}
}
```
## Coralogix
**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-bridge
シンガポール: https://ingress.coralogixsg.com/aws/event-bridge
アイルランド: https://ingress.coralogix.com/aws/event-bridge
アイルランド: https://ingress.coralogix.com/aws/event-bridge
インド: https://ingress.coralogix.in/aws/event-bridge
**追加情報**
イベントは、`applicationName=[AWS Account]` と `subsystemName=[event.source]` を使用してログエントリとして保存されます。
## Datadog
**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
**API 送信先の呼び出しエンドポイント URL:**
+ ログ: 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/ja_jp/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 ドキュメントの「[Ingestion API](https://docs.dynatrace.com/docs/platform/openpipeline/reference/api-ingestion-reference)」を参照してください。
## Freshworks
**API 送信先呼び出しエンドポイント URL**
エンドポイントのリストについては、[https://developers.freshworks.com/documentation/](https://developers.freshworks.com/documentation/) を参照してください。
**サポートされている認可タイプ**
Basic、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
**API 送信先呼び出しエンドポイント URL**
https://data.mongodb-api.com/app/*App ID*/endpoint/
**サポートされている認可タイプ**
API キー
E メール/パスワード
カスタム JWT 認証
**必要な追加の認可パラメータ**
なし
**MongoDBドキュメント**
[Atlas Data API](https://www.mongodb.com/docs/atlas/app-services/data-api/)
[エンドポイント](https://www.mongodb.com/docs/atlas/app-services/data-api/generated-endpoints/#endpoints)
[カスタム HTTP エンドポイント](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
**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/ja_jp/eventbridge/latest/userguide/eb-api-destination-partners.html)
**Momento ドキュメント:**
[Momento \$1 Amazon EventBridge](https://docs.momentohq.com/cache/integrations/amazon-eventbridge)
[Momento Topics API の使用](https://docs.momentohq.com/topics/develop/api-reference)
[Momento キャッシュの API リファレンス](https://docs.momentohq.com/cache/develop/api-reference)
**一般的に使用される API オペレーション:**
キャッシュの場合: `PUT`、`DELETE`
トピックの場合: `POST`
**追加情報:**
キャッシュを更新または削除する場合は、ルールターゲットの設定に次のクエリ文字列パラメータを含めます。
+ Momento キャッシュで更新するキー
+ キャッシュ項目の存続可能時間 (TTL)
例えば、入力イベントにこれらの値を持つ `details` フィールドが含まれている場合。
`key: $.details.key ttl_seconds: $.details.ttl_seconds`
## New Relic
**API 送信先呼び出しエンドポイント URL**
詳細については、「[EU および US リージョンのデータセンター](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers/)」をご覧ください。
**イベント**
**US–** https://insights-collector.newrelic.com/v1/accounts/*YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*/events
**EU–** https://insights-collector.eu01.nr-data.net/v1/accounts/*YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*/events
**メトリクス**
**US–** https://metric-api.newrelic.com/metric/v1
**EU–** https://metric-api.eu.newrelic.com/metric/v1
**ログ**
**US–** https://log-api.newrelic.com/log/v1
**EU–** https://log-api.eu.newrelic.com/log/v1
**トレース**
**US–** https://trace-api.newrelic.com/trace/v1
**EU–** 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
**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)
[Amazon EventBridge スケジューラパイプを使用した Operata AWS 統合](https://docs.operata.com/docs/aws-integration)
**一般的に使用される API オペレーション:**
`POST https://api.operata.io/v2/aws/events/contact-record`
**追加情報:**
`username` は Operata グループ ID で、パスワードは API トークンです。
## Salesforce
**API 送信先呼び出しエンドポイント URL**
**Sobject—** 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 クライアント認証情報
OAUTH トークンは、401 または 407 の応答が返されたときに更新されます。
**必要な追加の認可パラメータ**
[Salesforce Connected App](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_oauth_and_connected_apps.htm) は、クライアント ID とクライアントシークレットを提供します。
次の認可エンドポイントの 1 つです。
+ **生産—** https://*MyDomainName*.my.salesforce.com。 /services/oauth2/token
+ **拡張ドメインのないサンドボックス -** https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token
+ **拡張ドメインのあるサンドボックス -** https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token
次のキーと値のペアを指定します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/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
**API 送信先呼び出しエンドポイント URL**
エンドポイントおよびその他のリソースのリストについては、「[Slack ウェブ API を使う](https://api.slack.com/web)」を参照してください。
**サポートされている認可タイプ**
OAuth 2.0
OAUTH トークンは、401 または 407 の応答が返されたときに更新されます。
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 ルールを設定する場合、次の 2 つの設定を強調表示する必要があります。
+ コンテンツタイプを「application/json; charset=utf-8」として定義するヘッダーパラメータを含めます。
+ 入力トランスフォーマーを使用して、入力イベントを Slack API の期待される出力にマッピングします。つまり、Slack API に送信されるペイロードに「チャネル」と「テキスト」のキー/値のペアがあることを確認します。
## Shopify
**API 送信先呼び出しエンドポイント URL**
エンドポイントおよびその他のリソースとメソッドのリストについては、「[エンドポイントとリクエスト](https://shopify.dev/api/admin-rest#endpoints)」を参照してください。
**サポートされている認可タイプ**
OAuth、API キー
OAUTH トークンは、401 または 407 の応答が返されたときに更新されます。
**必要な追加の認可パラメータ**
該当しない
**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 ウェブフック配信](https://shopify.dev/apps/webhooks/configuration/eventbridge)
[Shopify 管理者のカスタムアプリケーションのアクセストークン](https://shopify.dev/apps/auth/admin-app-access-tokens)
[Product](https://shopify.dev/api/admin-rest/2021-10/resources/product#top)
[Shopify 管理者 API](https://shopify.dev/api/admin)
## Splunk
**API 送信先呼び出しエンドポイント URL**
https://*SPLUNK\$1HEC\$1ENDPOINT*:*optional\$1port*/services/collector/raw
**サポートされている認可タイプ**
Basic、API キー
**必要な追加の認可パラメータ**
なし
**Splunkドキュメント**
どちらの認可タイプでも、HEC トークン ID が必要です。詳細については、「[Set up and use HTTP Event Collector in Splunk Web](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 キーの名前は「Authorization」、値は 「Splunk HEC トークン ID」です。
Basic (ユーザー名/パスワード) - EventBridge のエンドポイントを設定する場合、ユーザー名は「Splunk」、パスワードは「Splunk HEC トークン ID」です。
## Sumo Logic
**API 送信先呼び出しエンドポイント URL**
HTTP ログとメトリクスソースのエンドポイント URL は、ユーザーごとに異なります。詳細については、「[HTTP ログおよびメトリクスのソース](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source)」を参照してください。
**サポートされている認可タイプ**
一意のキーが URL にベイクされているため、Sumo Logic は HTTP ソースでの認証は必要ありません。そのため、この URL は機密情報として扱う必要があります。
EventBridge API の宛先を設定する場合は、認可タイプが必要です。この要件を満たすには、[API Key] を選択し、キー名を「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\$1ID\$1PER\$1COLLECTOR*
**追加情報**
なし
## TriggerMesh
**API 送信先呼び出しエンドポイント URL**
「[HTTP のイベントソース](https://docs.triggermesh.io/concepts/sources)」のトピックの情報を使用して、エンドポイント URL を策定します。エンドポイント URL には、イベントソース名とユーザー名前空間が次の形式で含まれます。
https://*source-name*.*user-namespace*.cloud.triggermesh.io
エンドポイントへのリクエストには、Basic 認可パラメータを含めます。
**サポートされている認可タイプ**
Basic
**必要な追加の認可パラメータ**
なし
**TriggerMeshドキュメント**
[HTTP のイベントソース](https://docs.triggermesh.io/concepts/sources)
**一般的に使用される API オペレーション**
該当しない
**追加情報**
なし
## Zendesk
**API 送信先呼び出しエンドポイント URL**
https://developer.zendesk.com/rest\$1api/docs/support/tickets
**サポートされている認可タイプ**
Basic、API キー
**必要な追加の認可パラメータ**
なし
**Zendeskドキュメント**
[セキュリティと認証](https://developer.zendesk.com/rest_api/docs/support/introduction#security-and-authentication)
**一般的に使用される API オペレーション**
POST https://*your\$1Zendesk\$1subdomain*/api/v2/tickets
**追加情報**
EventBridge が行う API リクエストは、Zendesk API の制限に計上されます。現在のプランの Zendesk 制限については、「[使用制限](https://developer.zendesk.com/rest_api/docs/support/usage_limits)」を参照してください。
アカウントやデータをより安全に保護するには、基本的なサインイン認証情報による認証ではなく、API キーを使用することをお勧めします。