View a markdown version of this page

Eliminazione degli endpoint da Amazon Pinpoint in modo programmatico - Amazon Pinpoint
Esempi

Avviso di fine del supporto: il 30 ottobre 2026 AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta Fine del supporto di Amazon Pinpoint. Nota: le API relative a SMS, voce, push mobile, OTP e convalida del numero di telefono non sono interessate da questa modifica e sono supportate da End User Messaging. AWS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Eliminazione degli endpoint da Amazon Pinpoint in modo programmatico

Un endpoint rappresenta un metodo per contattare uno dei clienti. Ogni endpoint può fare riferimento all'indirizzo e-mail di un cliente, all'identificatore del dispositivo mobile, al numero di telefono o ad un altro tipo di destinazione a cui è possibile inviare messaggi. In molte giurisdizioni, le informazioni di questo tipo sono considerate personali. Puoi eliminare gli endpoint quando non desideri più inviare messaggi a una determinata destinazione, ad esempio quando la destinazione diventa irraggiungibile o quando un cliente chiude un account.

Esempi

Gli esempi seguenti illustrano come eliminare un endpoint.

AWS CLI

Puoi utilizzare Amazon Pinpoint eseguendo i comandi con l' AWS CLI.

Esempio Comando di eliminazione endpoint

Per eliminare un endpoint, usa il comando delete-endpoint:

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

Dove:

  • application-id è l'ID del progetto Amazon Pinpoint contenente l'endpoint.

  • endpoint-id è l'ID dell'endpoint da eliminare.

La risposta a questo comando è la definizione JSON dell'endpoint eliminato.

AWS SDK per Java

Puoi utilizzare l'API Amazon Pinpoint nelle applicazioni Java utilizzando il client fornito da AWS SDK per Java.

Esempio Codice

Per eliminare un endpoint, usa il metodo deleteEndpoint del client AmazonPinpoint. Specifica un oggetto DeleteEndpointRequest come argomento del metodo:

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

Per l'esempio completo dell'SDK, consulta DeleteEndpoint.java on. GitHub

HTTP

Puoi utilizzare Amazon Pinpoint effettuando richieste HTTP direttamente alla REST API.

Esempio Richiesta di eliminazione endpoint

Per eliminare un endpoint, invia una richiesta DELETE alla risorsa 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

Dove:

  • application-id è l'ID del progetto Amazon Pinpoint contenente l'endpoint.

  • endpoint-id è l'ID dell'endpoint da eliminare.

La risposta a questa richiesta è la definizione JSON dell'endpoint eliminato.