**支援終止通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `UpdateEndpoint` 搭配 AWS SDK 使用
以下程式碼範例顯示如何使用 `UpdateEndpoint`。
------
#### [ Java ]
**適用於 Java 2.x 的 SDK **
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/pinpoint#code-examples)中設定和執行。
```
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.EndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.GetEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.GetEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import software.amazon.awssdk.services.pinpoint.model.EndpointDemographic;
import software.amazon.awssdk.services.pinpoint.model.EndpointLocation;
import software.amazon.awssdk.services.pinpoint.model.EndpointUser;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.List;
import java.util.UUID;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;
import java.util.Date;
/**
* 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 UpdateEndpoint {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
appId - The ID of the application to create an endpoint for.
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String appId = args[0];
PinpointClient pinpoint = PinpointClient.builder()
.region(Region.US_EAST_1)
.build();
EndpointResponse response = createEndpoint(pinpoint, appId);
System.out.println("Got Endpoint: " + response.id());
pinpoint.close();
}
public static EndpointResponse createEndpoint(PinpointClient client, String appId) {
String endpointId = UUID.randomUUID().toString();
System.out.println("Endpoint ID: " + endpointId);
try {
EndpointRequest endpointRequest = createEndpointRequestData();
UpdateEndpointRequest updateEndpointRequest = UpdateEndpointRequest.builder()
.applicationId(appId)
.endpointId(endpointId)
.endpointRequest(endpointRequest)
.build();
UpdateEndpointResponse updateEndpointResponse = client.updateEndpoint(updateEndpointRequest);
System.out.println("Update Endpoint Response: " + updateEndpointResponse.messageBody());
GetEndpointRequest getEndpointRequest = GetEndpointRequest.builder()
.applicationId(appId)
.endpointId(endpointId)
.build();
GetEndpointResponse getEndpointResponse = client.getEndpoint(getEndpointRequest);
System.out.println(getEndpointResponse.endpointResponse().address());
System.out.println(getEndpointResponse.endpointResponse().channelType());
System.out.println(getEndpointResponse.endpointResponse().applicationId());
System.out.println(getEndpointResponse.endpointResponse().endpointStatus());
System.out.println(getEndpointResponse.endpointResponse().requestId());
System.out.println(getEndpointResponse.endpointResponse().user());
return getEndpointResponse.endpointResponse();
} catch (PinpointException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
private static EndpointRequest createEndpointRequestData() {
try {
List favoriteTeams = new ArrayList<>();
favoriteTeams.add("Lakers");
favoriteTeams.add("Warriors");
HashMap> customAttributes = new HashMap<>();
customAttributes.put("team", favoriteTeams);
EndpointDemographic demographic = EndpointDemographic.builder()
.appVersion("1.0")
.make("apple")
.model("iPhone")
.modelVersion("7")
.platform("ios")
.platformVersion("10.1.1")
.timezone("America/Los_Angeles")
.build();
EndpointLocation location = EndpointLocation.builder()
.city("Los Angeles")
.country("US")
.latitude(34.0)
.longitude(-118.2)
.postalCode("90068")
.region("CA")
.build();
Map metrics = new HashMap<>();
metrics.put("health", 100.00);
metrics.put("luck", 75.00);
EndpointUser user = EndpointUser.builder()
.userId(UUID.randomUUID().toString())
.build();
DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm'Z'"); // Quoted "Z" to indicate UTC, no timezone
// offset
String nowAsISO = df.format(new Date());
return EndpointRequest.builder()
.address(UUID.randomUUID().toString())
.attributes(customAttributes)
.channelType("APNS")
.demographic(demographic)
.effectiveDate(nowAsISO)
.location(location)
.metrics(metrics)
.optOut("NONE")
.requestId(UUID.randomUUID().toString())
.user(user)
.build();
} catch (PinpointException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
}
```
+ 如需 API 詳細資訊，請參閱 *AWS SDK for Java 2.x API 參考*中的 [UpdateEndpoint](https://docs.aws.amazon.com/goto/SdkForJavaV2/pinpoint-2016-12-01/UpdateEndpoint)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Amazon Pinpoint](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。