Supprimer des points de terminaison d'Amazon Pinpoint par programmation - Amazon Pinpoint
Exemples

Avis de fin de support : le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analyses). Pour plus d'informations, consultez la page de fin de support d'Amazon Pinpoint. Remarque : en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Supprimer des points de terminaison d'Amazon Pinpoint par programmation

Un point de terminaison représente une seule méthode de contact d'un de vos clients. Chaque point de terminaison peut faire référence à l'adresse e-mail d'un client, à l'identifiant d'un appareil mobile, au numéro de téléphone ou à tout autre type de destination auquel vous pouvez envoyer des messages. Dans de nombreux juridictions, ce type de données peut être considéré comme des renseignements personnels. Vous pouvez supprimer des points de terminaison lorsque vous ne souhaitez plus envoyer de messages à une destination spécifique, par exemple lorsque la destination devient inaccessible, ou lorsqu'un client clôt un compte.

Exemples

Les exemples suivants vous indiquent comment supprimer un point de terminaison.

AWS CLI

Vous pouvez utiliser Amazon Pinpoint en exécutant des commandes avec l' AWS CLI.

Exemple Commande de suppression d'un point de terminaison

Pour supprimer un point de terminaison, utilisez la commande delete-endpoint :

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

Où :

  • application-id correspond à l'ID du projet Amazon Pinpoint contenant le point de terminaison.

  • endpoint-id correspond à l'ID du point de terminaison que vous supprimez.

La réponse à cette commande est la définition JSON du point de terminaison que vous avez supprimé.

AWS SDK pour Java

Vous pouvez utiliser l'API Amazon Pinpoint dans vos applications Java en utilisant le client fourni par AWS SDK pour Java.

Exemple Code

Pour supprimer un point de terminaison, utilisez la méthode deleteEndpoint du client AmazonPinpoint. Fournissez un objet DeleteEndpointRequest comme argument de la méthode :

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");
    }
}

Pour l'exemple complet du SDK, consultez DeleteEndpoint.java on. GitHub

HTTP

Vous pouvez utiliser Amazon Pinpoint en effectuant des demandes HTTP directement à l'API REST.

Exemple Demande de point de terminaison DELETE

Pour supprimer un point de terminaison, envoyez une demande DELETE à la ressource Endpoint :

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

Où :

  • application-id correspond à l'ID du projet Amazon Pinpoint contenant le point de terminaison.

  • endpoint-id correspond à l'ID du point de terminaison que vous supprimez.

La réponse à cette demande est la définition JSON du point de terminaison que vous avez supprimé.