Programmgesteuertes Löschen von Endpunkten aus Amazon Pinpoint - Amazon Pinpoint
Beispiele

Hinweis zum Ende des Supports: Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter Ende des Amazon-Pinpoint-Supports. Hinweis: APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Programmgesteuertes Löschen von Endpunkten aus Amazon Pinpoint

Ein Endpunkt stellt eine einzelne Methode zur Kontaktaufnahme mit einem Kunden dar. Jeder Endpunkt kann sich auf eine E-Mail-Adresse eines Kunden, die ID eines Mobilgeräts, eine Telefonnummer oder einen anderen Zieltyp beziehen, an den Sie Nachrichten senden können. In vielen Zuständigkeiten gelten diese Informationen als persönlich. Sie können Endpunkte löschen, wenn Sie keine Nachrichten mehr an ein bestimmtes Ziel senden wollen, z. B. wenn das Ziel nicht mehr erreichbar ist, oder wenn ein Kunde ein Konto schließt.

Beispiele

Die folgenden Beispiele zeigen Ihnen, wie Sie einen Endpunkt löschen.

AWS CLI

Sie können Amazon Pinpoint verwenden, indem Sie Befehle mit der AWS CLI ausführen.

Beispiel Befehl zum Löschen eines Endpunkts

Zum Löschen eines Endpunkts verwenden Sie den Befehl delete-endpoint:

$ aws pinpoint delete-endpoint \
> --application-id application-id \
> --endpoint-id endpoint-id

Wobei gilt:

  • application-id ist die ID des Amazon-Pinpoint-Projekts, das den Endpunkt enthält.

  • endpoint-id ist die ID des Endpunkts, den Sie löschen.

Die Ausgabe dieses Befehls ist die JSON-Definition des Endpunkts, den Sie gelöscht haben.

AWS SDK for Java

Sie können die Amazon-Pinpoint-API in Ihren Java-Anwendungen verwenden, indem Sie den vom AWS SDK for Java bereitgestellten Client verwenden.

Beispiel Code

Um einen Endpunkt zu löschen, verwenden Sie die Methode deleteEndpoint des AmazonPinpoint-Clients. Geben Sie ein DeleteEndpointRequest-Objekt als Methodenargument an:

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.DeleteEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.DeleteEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.DeleteEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.DeleteEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class DeleteEndpoint {
    public static void main(String[] args) {
        final String usage = """

                Usage:   <appName> <endpointId >

                Where:
                  appId - The id of the application to delete.
                  endpointId - The id of the endpoint to delete.
                """;

        if (args.length != 2) {
            System.out.println(usage);
            System.exit(1);
        }

        String appId = args[0];
        String endpointId = args[1];
        System.out.println("Deleting an endpoint with id: " + endpointId);
        PinpointClient pinpoint = PinpointClient.builder()
                .region(Region.US_EAST_1)
                .build();

        deletePinEncpoint(pinpoint, appId, endpointId);
        pinpoint.close();
    }

    public static void deletePinEncpoint(PinpointClient pinpoint, String appId, String endpointId) {
        try {
            DeleteEndpointRequest appRequest = DeleteEndpointRequest.builder()
                    .applicationId(appId)
                    .endpointId(endpointId)
                    .build();

            DeleteEndpointResponse result = pinpoint.deleteEndpoint(appRequest);
            String id = result.endpointResponse().id();
            System.out.println("The deleted endpoint id  " + id);

        } catch (PinpointException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
        System.out.println("Done");
    }
}

Das vollständige SDK-Beispiel finden Sie unter DeleteEndpoint.java on. GitHub

HTTP

Sie können Amazon Pinpoint verwenden, indem Sie HTTP-Anforderungen direkt an die REST-API stellen.

Beispiel DELETE-Anforderung zum Löschen eines Endpunkts

Um einen Endpunkt zu löschen, führen Sie eine DELETE-Anforderung an die Ressource Endpunkt aus:

DELETE /v1/apps/application-id/endpoints/endpoint-id HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache

Wobei gilt:

  • application-id ist die ID des Amazon-Pinpoint-Projekts, das den Endpunkt enthält.

  • endpoint-id ist die ID des Endpunkts, den Sie löschen.

Die Ausgabe dieser Anforderung ist die JSON-Definition des Endpunkts, den Sie gelöscht haben.