Eliminar puntos de conexión de Amazon Pinpoint mediante programación - Amazon Pinpoint
Ejemplos

Aviso de fin de soporte: el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte Fin de soporte de Amazon Pinpoint. Nota: Este cambio no afecta a las API relacionadas con los SMS, los mensajes de voz, las notificaciones push móviles, la OTP y la validación de números de teléfono, por lo que son compatibles con Mensajería para usuarios finales de AWS.

Eliminar puntos de conexión de Amazon Pinpoint mediante programación

Un punto de enlace representa un único método de ponerse en contacto con uno de sus clientes. Cada punto de enlace puede hacer referencia a la dirección de correo electrónico de un cliente, al identificador del dispositivo móvil, al número de teléfono o a otro tipo de destino al que puede enviar mensajes. En muchas jurisdicciones, este tipo de información puede considerarse personal. Puede eliminar puntos de conexión cuando ya no desee enviar mensajes a un destino determinado, por ejemplo, si el destino deja de estar disponible o cuando un cliente cierra una cuenta.

Ejemplos

En los siguientes ejemplos puede ver cómo eliminar un punto de enlace.

AWS CLI

Puede utilizar Amazon Pinpoint ejecutando comandos con la AWS CLI.

ejemplo Comando Delete Endpoint

Para eliminar un punto de enlace, utilice el comando delete-endpoint:

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

Donde:

  • application-id es el ID del proyecto de Amazon Pinpoint que contiene el punto de conexión.

  • endpoint-id es el ID del punto de enlace que está eliminando.

La respuesta a este comando es la definición JSON del punto de enlace que eliminó.

AWS SDK para Java

Puede usar la API de Amazon Pinpoint en las aplicaciones Java mediante el cliente que proporciona AWS SDK para Java.

ejemplo Código

Para eliminar un punto de conexión, utilice el método deleteEndpoint del cliente de AmazonPinpoint. Proporcione un objeto DeleteEndpointRequest como argumento de método:

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

Para ver el ejemplo completo del SDK, consulte DeleteEndpoint.java en GitHub.

HTTP

Puede utilizar Amazon Pinpoint realizando solicitudes HTTP directamente a la API de REST.

ejemplo Solicitud DELETE al punto de enlace

Para eliminar un punto de enlace, emita una solicitud DELETE al recurso Punto de enlace:

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

Donde:

  • application-id es el ID del proyecto de Amazon Pinpoint que contiene el punto de conexión.

  • endpoint-id es el ID del punto de enlace que está eliminando.

La respuesta a esta solicitud es la definición JSON del punto de enlace que eliminó.