Parceiros de destino da API - Amazon EventBridge

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Parceiros de destino da API

Use as informações fornecidas pelos seguintes AWS parceiros para configurar um destino de API e uma conexão para seu serviço ou aplicativo.

Confluente

URL do endpoint de invocação de destino da API:

Normalmente, o seguinte formato:

https://random-id.region.aws.confluent.cloud:443/kafka/v3/clusters/cluster-id/topics/topic-name/records

Para obter mais informações, consulte Encontre o endereço do endpoint REST e o ID do cluster na documentação do Confluent.

Tipos de autorização compatíveis:

Basic

Parâmetros adicionais de autorização necessários:

Não aplicável

Documentação confluente:

Produzir registros

Proxy REST confluente para Apache Kafka

Operações de API comumente usadas:

POST

Informações adicionais

Para transformar os dados do evento em uma mensagem que o endpoint possa processar, crie um transformador de entrada de destino.

  • Para gerar um registro sem especificar uma chave de particionamento do Kafka, use o modelo a seguir para seu transformador de entrada. Nenhum caminho de entrada é necessário.

    { "value":{ "type":"JSON", "data":aws.events.event.json }, }
  • Para gerar um registro usando um campo de dados do evento como chave de particionamento do Kafka, siga o caminho de entrada e o exemplo do modelo abaixo. Este exemplo define o caminho de entrada para o orderId campo e, em seguida, especifica esse campo como a chave de partição.

    Primeiro, defina o caminho de entrada para o campo de dados do evento:

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

    Em seguida, use o modelo do transformador de entrada para especificar o campo de dados como a chave de partição:

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

Coralogix

URL do endpoint de invocação de destino da API

Para obter uma lista completa de endpoints, consulte Referência da API do Coralogix.

Tipos de autorização compatíveis

Chave de API

Parâmetros adicionais de autorização necessários

Cabeçalho "x-amz-event-bridge-access-key", o valor é a chave da API Coralogix

Documentação da Coralogix

EventBridgeAutenticação da Amazon

Operações de API comumente usadas

EUA: https://ingress.coralogix.us/aws/event-bridge

Cingapura: https://ingress.coralogixsg.com/aws/event-bridge

Irlanda: https://ingress.coralogix.com/aws/event-bridge

Estocolmo: https://ingress.eu2.coralogix.com/aws/event-bridge

Índia: https://ingress.coralogix.in/aws/event-bridge

Informações adicionais

Os eventos são armazenados como entradas de log com applicationName=[AWS Account] e subsystemName=[event.source].

Datadog

URL do endpoint de invocação de destino da API

Para obter uma lista completa de endpoints, consulte Referência da API do Datadog.

Tipos de autorização compatíveis

Chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Documentação da Datadog

Autenticação

Operações de API comumente usadas

POST https://api.datadoghq.com/api/v1/events

POST https://http-intake.logs.datadoghq.com/v1/input

Informações adicionais

Os URLs de endpoint diferem dependendo da localização da sua organização do Datadog. Para obter o URL correto para sua organização, consulte a documentação

Freshworks

URL do endpoint de invocação de destino da API

Para obter uma lista de endpoints, consulte https://developers.freshworks.com/documentation/

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Não aplicável

Documentação da Freshworks

Autenticação

Operações de API comumente usadas

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

Informações adicionais

Nenhum

MongoDB

URL do endpoint de invocação de destino da API

https://data.mongodb-api.com/app/App ID/endpoint/

Tipos de autorização compatíveis

Chave de API

E-mail/senha

Autenticação JWT personalizada

Parâmetros adicionais de autorização necessários

Nenhum

Documentação da MongoDB

API de dados do Atlas

Endpoints

Endpoints HTTPS personalizados

Autenticação

Operações de API comumente usadas

Nenhum

Informações adicionais

Nenhum

New Relic

URL do endpoint de invocação de destino da API

Para obter mais informações, consulte Nossos datacenters nas regiões da UE e dos EUA.

Eventos

EUA: https://insights-collector.newrelic.com/v1/accounts/YOUR_NEW_RELIC_ACCOUNT_ID/events

UE: https://insights-collector.eu01.nr-data.net/v1/accounts/YOUR_NEW_RELIC_ACCOUNT_ID/events

Métricas

EUA: https://metric-api.newrelic.com/metric/v1

UE: https://metric-api.eu.newrelic.com/metric/v1

Logs

EUA: https://log-api.newrelic.com/log/v1

UE: https://log-api.eu.newrelic.com/log/v1

Rastreamentos

EUA: https://trace-api.newrelic.com/trace/v1

UE: https://trace-api.eu.newrelic.com/trace/v1

Tipos de autorização compatíveis

Chave de API

Documentação da New Relic

Métrica de API

API de eventoshttps://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/

Registrar API

API de rastreamento

Operações de API comumente usadas

Métrica de API

API de eventoshttps://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/

Registrar API

API de rastreamento

Informações adicionais

Limites métricos de API

Limites da API de eventos

Limites de registro da API

Limites de rastreamento de API

Operata

URL do endpoint de invocação de destino da API:

https://api.operata.io/v2/aws/events/contact-record

Tipos de autorização compatíveis:

Basic

Parâmetros adicionais de autorização necessários:

Nenhum

Documentação do Operata:

Como criar, visualizar, alterar e revogar tokens de API?

AWS Integração do Operata usando Amazon EventBridge Scheduler Pipes

Operações de API comumente usadas:

POST https://api.operata.io/v2/aws/events/contact-record

Informações adicionais

O username é o ID do grupo Operata e a senha é seu token de API.

Salesforce

URL do endpoint de invocação de destino da API

Assunto — https://myDomainName.my.salesforce.com/services/data/ versionNumber /sobjects//* SobjectEndpoint

Eventos de plataforma personalizados — https://myDomainName.my.salesforce.com/services/data/versionNumber /sobjects/ /* customPlatformEndpoint

Para obter uma lista completa de endpoints, consulte Referência da API do Salesforce

Tipos de autorização compatíveis

Credenciais de cliente OAuth

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é retornada.

Parâmetros adicionais de autorização necessários

ID do cliente da aplicação Salesforce conectada e segredo do cliente.

Um dos seguintes endpoints de autorização:

  • Produção — https://MyDomainName.my.salesforce.com. /services/oauth2/token

  • Sandbox sem domínios aprimorados — https://MyDomainName-- SandboxName.my. salesforce.com/services /oauth2/token

  • Sandbox com domínios aprimorados — https://MyDomainName-- .sandbox.my.salesforce.com/services/oauth2/token SandboxName

O seguinte par de chave/valor:

Chave Valor

grant_type

client_credentials

Documentação da Salesforce

Guia do desenvolvedor da API REST

Operações de API comumente usadas

Como trabalhar com metadados de objeto

Trabalhar com registros

Informações adicionais

Para ver um tutorial explicando como usar o EventBridge console para criar uma conexãoSalesforce, um destino de API e uma regra para a qual encaminhar informaçõesSalesforce, consulteTutorial: criar uma conexão com o Salesforce como destino de API.

Slack

URL do endpoint de invocação de destino da API

Para ver uma lista de endpoints e outros recursos, consulte Como usar a API Web do Slack

Tipos de autorização compatíveis

OAuth 2.0

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é retornada.

Ao criar uma aplicação Slack e a instala no seu espaço de trabalho, um token portador do OAuth será criado em seu nome para ser usado para autenticar chamadas pela sua conexão de destino da API.

Parâmetros adicionais de autorização necessários

Não aplicável

Documentação da Slack

Configuração básica da aplicação

Como instalar com OAuth

Como recuperar mensagens

Enviar mensagens

Como enviar mensagens usando webhooks de entrada

Operações de API comumente usadas

https://slack.com/api/chat.postMessage

Informações adicionais

Ao configurar sua EventBridge regra, há duas configurações a serem destacadas:

  • Inclua um parâmetro de cabeçalho que defina o tipo de conteúdo como "application/json; charset=utf-8".

  • Use um transformador de entrada para mapear o evento de entrada para a saída esperada para a API do Slack, ou seja, certifique-se de que a carga enviada para a API do Slack tenha pares de chave/valor de "pipe" e "texto".

Shopify

URL do endpoint de invocação de destino da API

Para obter uma lista de endpoints e outros recursos e métodos, consulte Endpoints e solicitações.

Tipos de autorização compatíveis

OAuth, chave de API

nota

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é retornada.

Parâmetros adicionais de autorização necessários

Não aplicável

Documentação da Shopify

Visão geral de autenticação e autorização

Operações de API comumente usadas

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

EXCLUIR: admin/api/2022-01/products/{product_id}.json

Informações adicionais

Crie uma aplicação

Entrega de EventBridge webhook da Amazon

Tokens de acesso para aplicações personalizadas no administrador da Shopify

Produto

API de administração da Shopify

Splunk

URL do endpoint de invocação de destino da API

https://SPLUNK_HEC_ENDPOINT:optional_port/services/collector/raw

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Documentação da Splunk

Para os dois tipos de autorização, você precisa de um ID de token HEC. Para obter mais informações, consulte Configurar e usar o Coletor de eventos HTTP no Splunk Web.

Operações de API comumente usadas

POST https://SPLUNK_HEC_ENDPOINT:optional_port/services/collector/raw

Informações adicionais

Chave de API — Ao configurar o endpoint para EventBridge, o nome da chave da API é “Autorização” e o valor é o ID do token Splunk HEC.

Básico (nome de usuário/senha) — Ao configurar o endpoint para EventBridge, o nome de usuário é “Splunk” e a senha é o ID do token Splunk HEC.

Sumo Logic

URL do endpoint de invocação de destino da API

Os URLs do endpoint HTTP Log e Metric Source serão diferentes para cada usuário. Para obter mais informações, consulte Origem de logs e métricas HTTP.

Tipos de autorização compatíveis

O Sumo Logic não exige autenticação em suas origens HTTP porque há uma chave exclusiva embutida na URL. Por este motivo, é preciso tratar o URL como um segredo.

Quando você configura o destino EventBridge da API, é necessário um tipo de autorização. Para atender a esse requisito, selecione Chave de API e atribua a ela um nome de chave de "chave fictícia" e um valor de chave de "valor fictício".

Parâmetros adicionais de autorização necessários

Não aplicável

Documentação da Sumo Logic

Sumo Logicjá criou fontes hospedadas para coletar registros e métricas de vários AWS serviços e você pode usar as informações do site deles para trabalhar com essas fontes. Para obter mais informações, consulte Amazon Web Services.

Se você estiver gerando eventos personalizados a partir de um aplicativo e quiser enviá-los Sumo Logic como registros ou métricas, use destinos de EventBridge API e endpoints Sumo Logic HTTP Log and Metric Source.

Operações de API comumente usadas

PUBLICAR https://endpoint4.collection.us2.sumologic.com/receiver/v1/http/UNIQUE_ID_PER_COLLECTOR

Informações adicionais

Nenhum

TriggerMesh

URL do endpoint de invocação de destino da API

Use as informações no tópico Origem do evento para HTTP para formular a URL do endpoint. Um URL de endpoint inclui o nome da origem do evento e o namespace do usuário no seguinte formato:

https://source-name.user-namespace.cloud.triggermesh.io

Inclui os parâmetros de autorização básicos na solicitação do endpoint.

Tipos de autorização compatíveis

Basic

Parâmetros adicionais de autorização necessários

Nenhum

Documentação da TriggerMesh

Origem do evento para HTTP

Operações de API comumente usadas

Não aplicável

Informações adicionais

Nenhum

Zendesk

URL do endpoint de invocação de destino da API

https://developer.zendesk.com/rest_api/docs/support/tickets

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Documentação da Zendesk

Segurança e autenticação

Operações de API comumente usadas

POST https://your_Zendesk_subdomain/api/v2/tickets

Informações adicionais

As solicitações de API são EventBridge contabilizadas em relação aos seus limites de API do Zendesk. Para obter informações sobre os limites do Zendesk para seu plano, consulte Limites de uso.

Para proteger melhor sua conta e seus dados, recomendamos usar uma chave de API em vez da autenticação básica de credenciais de login.