Auflisten von Endpunkt-IDs mit Amazon Pinpoint

Um einen Endpunkt zu aktualisieren oder zu löschen, benötigen Sie die Endpunkt-ID. Wenn Sie also diese Operationen für alle Endpunkte eines Amazon-Pinpoint-Projekts durchführen möchten, ist der erste Schritt die Auflistung aller Endpunkt-IDs, die zu diesem Projekt gehören. Anschließend können Sie diese IDs durchlaufen, um beispielsweise Attribut global hinzuzufügen oder alle Endpunkte in Ihrem Projekt zu löschen.

Das folgende Beispiel verwendet AWS SDK for Java und führt die folgenden Schritte aus:

1. Ruft die Beispielmethode exportEndpointsToS3 aus dem Beispielcode in Exportieren von Endpunkten aus Amazon Pinpoint auf. Diese Methode exportiert die Endpunktdefinitionen aus einem Amazon-Pinpoint-Projekt. Die Endpunktdefinitionen werden als gzip-Dateien einem Amazon-S3-Bucket hinzugefügt.

2. Lädt die exportierten gzip-Dateien herunter.

3. Liest die gzip-Dateien und erhält die Endpunkt-ID aus der JSON-Definition der einzelnen Endpunkte.

4. Gibt die Endpunkt-IDs auf der Konsole aus.

5. Bereinigt die Daten durch Löschen der Dateien, die Amazon Pinpoint Amazon S3 hinzugefügt hat.

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.EndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.GetUserEndpointsRequest;
import software.amazon.awssdk.services.pinpoint.model.GetUserEndpointsResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.List;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.EndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.GetUserEndpointsRequest;
import software.amazon.awssdk.services.pinpoint.model.GetUserEndpointsResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.List;

/**
 * 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 ListEndpointIds {
    public static void main(String[] args) {
        final String usage = """

                Usage:    <applicationId> <userId>

                Where:
                   applicationId - The ID of the Amazon Pinpoint application that has the endpoint.
                   userId - The user id applicable to the endpoints""";

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

        String applicationId = args[0];
        String userId = args[1];
        PinpointClient pinpoint = PinpointClient.builder()
                .region(Region.US_EAST_1)
                .build();

        listAllEndpoints(pinpoint, applicationId, userId);
        pinpoint.close();
    }

    public static void listAllEndpoints(PinpointClient pinpoint,
            String applicationId,
            String userId) {

        try {
            GetUserEndpointsRequest endpointsRequest = GetUserEndpointsRequest.builder()
                    .userId(userId)
                    .applicationId(applicationId)
                    .build();

            GetUserEndpointsResponse response = pinpoint.getUserEndpoints(endpointsRequest);
            List<EndpointResponse> endpoints = response.endpointsResponse().item();

            // Display the results.
            for (EndpointResponse endpoint : endpoints) {
                System.out.println("The channel type is: " + endpoint.channelType());
                System.out.println("The address is  " + endpoint.address());
            }

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

Das vollständige SDK-Beispiel finden Sie unter ListEndpointIs.java auf GitHub.