Excluir uma conta usando a API do Serviço de fluxo

Última atualização: 4 de abril de 2025
  • Tópicos:

Criado para:

  • Desenvolvedor

Você pode excluir as contas de origem que contêm erros ou que se tornaram obsoletas usando a Flow Service API.

Consulte o tutorial a seguir para obter etapas sobre como excluir uma conta usando a API.

Introdução

Este tutorial requer que você tenha uma ID de conexão válida. Se você não tiver uma ID de conexão válida, selecione seu conector preferido na visão geral das fontes e siga as etapas descritas antes de tentar este tutorial.

Este tutorial também requer que você tenha uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

  • Fontes: Experience Platform permite que os dados sejam assimilados de várias fontes e fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
  • Sandboxes: Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

Uso de APIs do Experience Platform

Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.

Excluir conta

DICA
Antes de excluir a conta de origem, primeiro você deve excluir todos os fluxos de dados existentes associados à conta de origem. Para excluir fluxos de dados existentes, consulte o tutorial em exclusão de fluxos de dados de fontes.

Para excluir uma conta, faça uma solicitação DELETE à API Flow Service enquanto fornece a ID de conexão básica que corresponde à conta que você deseja excluir.

Formato da API

DELETE /connections/{BASE_CONNECTION_ID}
ParâmetroDescrição
{BASE_CONNECTION_ID}A ID da conexão básica da conta de origem que você deseja excluir.

Solicitação

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/flowservice/connections/dd3631cd-d0ea-4fea-b631-cdd0ea6fea21' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Resposta

Uma resposta bem-sucedida retorna o status HTTP 204 (Sem conteúdo) e um corpo em branco.

Você pode confirmar a exclusão tentando uma solicitação de pesquisa (GET) para a conexão.

Próximas etapas

Ao seguir este tutorial, você usou com êxito a API Flow Service para excluir contas existentes.

Para obter etapas sobre como executar essas operações usando a interface do usuário, consulte o tutorial em exclusão de contas na interface.