Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Migrieren eines benutzerdefinierten Domainnamens in einen anderen API-Endpunkt in API Gateway
Sie können Ihren benutzerdefinierten Domänennamen zwischen Edge-optimierten und regionalen Endpunkten migrieren. Sie können einen öffentlichen benutzerdefinierten Domainnamen nicht zu einem privaten benutzerdefinierten Domainnamen migrieren. Zunächst fügen Sie den neuen Endpunktkonfigurationstyp zur bestehenden Liste `endpointConfiguration.types` für den benutzerdefinierten Domänennamen hinzu. Danach richten Sie einen DNS-Datensatz so ein, dass der benutzerdefinierte Domänenname auf den neu bereitgestellten Endpunkt verweist. Zum Schluss entfernen Sie den veralteten Endpunkt des benutzerdefinierten Domainnamens.
## Überlegungen
Im Folgenden finden Sie Überlegungen für die Migration Ihrer benutzerdefinierten Domain von einem regionalen API-Endpunkt zu einem Edge-optimierten API-Endpunkt:
+ Ein Edge-optimierter benutzerdefinierter Domainname erfordert ein von ACM bereitgestelltes Zertifikat aus der `us-east-1`-Region (USA Ost (Nord-Virginia)). Dieses Zertifikat wird auf alle geografischen Standorte verteilt.
+ Für einen regionalen benutzerdefinierten Domainnamen ist ein Zertifikat erforderlich, das von ACM in derselben Region bereitgestellt wird, in der die API gehostet wird. Sie können einen Edge-optimierten benutzerdefinierten Domainnamen, der sich außerhalb der `us-east-1`-Region befindet, zu einem regionalen benutzerdefinierten Domainnamen migrieren, indem Sie zunächst ein neues ACM-Zertifikat aus der aktuellen Region der API anfordern.
+ Die Migration von einem Edge-optimierten zu einem regionalen benutzerdefinierten Domainnamen kann bis zu 60 Sekunden dauern. Die Migrationszeit hängt auch davon ab, wann Sie Ihre DNS-Datensätze aktualisieren.
+ Sie können eine zusätzliche Endpunktkonfiguration nur hinzufügen, wenn der Endpunktzugriffsmodus auf eingestellt ist`BASIC`. Sobald Sie zwei Endpunktkonfigurationen haben, können Sie den Endpunktzugriffsmodus nicht mehr ändern. Weitere Informationen finden Sie unter [Endpunktzugriffsmodus](apigateway-security-policies.md#apigateway-security-policies-endpoint-access-mode).
+ Wenn Ihr benutzerdefinierter Domainname eine Sicherheitsrichtlinie verwendet, die damit beginnt`SecurityPolicy_`, dass, wenn Sie einen neuen Endpunktkonfigurationstyp hinzufügen, der Endpunktzugriffsmodus für beide Endpunkttypen identisch ist, und Sie müssen eine Sicherheitsrichtlinie auswählen, die mit `SecurityPolicy_` für den neuen Endpunktkonfigurationstyp beginnt.
## Migrieren von benutzerdefinierten Domainnamen
**Anmerkung**
Um die Migration abzuschließen, stellen Sie sicher, dass Sie den veralteten Endpunkt aus Ihrem benutzerdefinierten Domainnamen entfernen.
Gehen Sie wie folgt vor, um einen regionalen benutzerdefinierten Domainnamen zu einem Edge-optimierten benutzerdefinierten Domainnamen zu migrieren.
------
#### [ AWS-Managementkonsole ]
1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway).
1. Wählen Sie **Benutzerdefinierte Domainnamen** im Hauptnavigationsbereich aus.
1. Wählen Sie einen Edge-optimierten benutzerdefinierten Domainnamen aus.
1. Klicken Sie unter **Endpunktkonfiguration** auf **Bearbeiten**.
1. Wählen Sie **Regionalen Endpunkt hinzufügen** aus.
1. Wählen Sie unter **ACM-Zertifikat** ein Zertifikat aus.
Das regionale Zertifikat muss sich in derselben Region befinden wie die regionale API.
1. Wählen Sie **Änderungen speichern ** aus.
1. Richten Sie einen DNS-Datensatz so ein, dass der regionale benutzerdefinierte Domainname auf diesen regionalen Hostnamen verweist. Weitere Informationen finden Sie unter [Konfiguration von Route 53 zur Weiterleitung von Datenverkehr an API Gateway](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-api-gateway.html).
1. Nachdem Sie bestätigt haben, dass Ihre DNS-Konfiguration den richtigen Endpunkt verwendet, löschen Sie die Edge-optimierte Endpunktkonfiguration. Wählen Sie Ihren benutzerdefinierten Domainnamen aus und klicken Sie dann unter **Edge-optimierte Endpunktkonfiguration** auf **Löschen**.
1. Bestätigen Sie Ihre Auswahl und löschen Sie den Endpunkt.
------
#### [ AWS CLI ]
Der folgende [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl migriert einen Edge-optimierten benutzerdefinierten Domainnamen zu einem regionalen benutzerdefinierten Domainnamen:
```
aws apigateway update-domain-name \
--domain-name 'api.example.com' \
--patch-operations '[
{ "op":"add", "path": "/endpointConfiguration/types","value": "REGIONAL" },
{ "op":"add", "path": "/regionalCertificateArn", "value": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149" }
]'
```
Das regionale Zertifikat muss sich in derselben Region befinden wie die regionale API.
Die Ausgabe sieht wie folgt aus:
```
{
"certificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a",
"certificateName": "edge-cert",
"certificateUploadDate": "2017-10-16T23:22:57Z",
"distributionDomainName": "d1frvgze7vy1bf.cloudfront.net",
"domainName": "api.example.com",
"endpointConfiguration": {
"types": [
"EDGE",
"REGIONAL"
]
},
"regionalCertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149",
"regionalDomainName": "d-fdisjghyn6.execute-api.us-west-2.amazonaws.com"
}
```
Für den migrierten regionalen benutzerdefinierten Domänennamen gibt die resultierende Eigenschaft `regionalDomainName` den regionalen API-Hostnamen zurück. Sie müssen einen DNS-Datensatz so einrichten, dass der regionale benutzerdefinierte Domänenname auf diesen regionalen Hostnamen verweist. Auf diese Weise kann der Datenverkehr, der an den benutzerdefinierten Domänennamen gebunden ist, an den regionalen Host weitergeleitet werden.
Nachdem Sie den DNS-Datensatz eingerichtet haben, können Sie den Edge-optimierten benutzerdefinierten Domainnamen entfernen. Der folgende [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl entfernt den Edge-optimierten benutzerdefinierten Domänennamen:
```
aws apigateway update-domain-name \
--domain-name api.example.com \
--patch-operations '[
{"op":"remove", "path":"/endpointConfiguration/types", "value":"EDGE"},
{"op":"remove", "path":"certificateName"},
{"op":"remove", "path":"certificateArn"}
]'
```
------
Das folgende Verfahren zeigt, wie Sie einen Edge-optimierten benutzerdefinierten Domänennamen, der eine erweiterte Sicherheitsrichtlinie verwendet, zu einem regionalen benutzerdefinierten Domänennamen migrieren, der ebenfalls eine erweiterte Sicherheitsrichtlinie verwendet.
------
#### [ AWS-Managementkonsole ]
1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway).
1. Wählen Sie **Benutzerdefinierte Domainnamen** im Hauptnavigationsbereich aus.
1. Wählen Sie einen Edge-optimierten benutzerdefinierten Domainnamen aus.
1. Klicken Sie unter **Endpunktkonfiguration** auf **Bearbeiten**.
1. Wählen Sie **Regionalen Endpunkt hinzufügen** aus.
1. Wählen Sie unter **ACM-Zertifikat** ein Zertifikat aus.
Das regionale Zertifikat muss sich in derselben Region befinden wie die regionale API.
1. Wählen Sie für **Sicherheitsrichtlinie** eine Sicherheitsrichtlinie aus, die mit beginnt. `SecurityPolicy_`
1. Wählen Sie für **den Endpunktzugriffsmodus** die Option **Basic**.
1. Wählen Sie **Änderungen speichern ** aus.
1. Richten Sie einen DNS-Datensatz so ein, dass der regionale benutzerdefinierte Domainname auf diesen regionalen Hostnamen verweist. Weitere Informationen finden Sie unter [Konfiguration von Route 53 zur Weiterleitung von Datenverkehr an API Gateway](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-api-gateway.html).
1. Nachdem Sie bestätigt haben, dass Ihre DNS-Konfiguration den richtigen Endpunkt verwendet, löschen Sie die Edge-optimierte Endpunktkonfiguration. Wählen Sie Ihren benutzerdefinierten Domainnamen aus und klicken Sie dann unter **Edge-optimierte Endpunktkonfiguration** auf **Löschen**.
1. Bestätigen Sie Ihre Auswahl und löschen Sie den Endpunkt.
------
#### [ AWS CLI ]
Der folgende [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl migriert einen Edge-optimierten benutzerdefinierten Domainnamen zu einem regionalen benutzerdefinierten Domainnamen:
```
aws apigateway update-domain-name \
--domain-name 'api.example.com' \
--patch-operations '[
{ "op":"add", "path": "/endpointConfiguration/types","value": "REGIONAL" },
{ "op":"replace", "path": "/securityPolicy", "value":"SecurityPolicy_TLS13_1_3_2025_09"},
{ "op":"add", "path": "/regionalCertificateArn", "value": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149" }
]'
```
Das regionale Zertifikat muss sich in derselben Region befinden wie die regionale API.
Die Ausgabe sieht wie folgt aus:
```
{
"certificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a",
"certificateName": "edge-cert",
"certificateUploadDate": "2017-10-16T23:22:57Z",
"distributionDomainName": "d1frvgze7vy1bf.cloudfront.net",
"domainName": "api.example.com",
"endpointConfiguration": {
"types": [
"EDGE",
"REGIONAL"
]
},
"securityPolicy": "SecurityPolicy_TLS13_1_3_2025_09",
"endpointAccessMode": "BASIC",
"regionalCertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149",
"regionalDomainName": "d-fdisjghyn6.execute-api.us-west-2.amazonaws.com"
}
```
Für den migrierten regionalen benutzerdefinierten Domänennamen gibt die resultierende Eigenschaft `regionalDomainName` den regionalen API-Hostnamen zurück. Sie müssen einen DNS-Datensatz so einrichten, dass der regionale benutzerdefinierte Domänenname auf diesen regionalen Hostnamen verweist. Auf diese Weise kann der Datenverkehr, der an den benutzerdefinierten Domänennamen gebunden ist, an den regionalen Host weitergeleitet werden.
Nachdem Sie den DNS-Datensatz eingerichtet haben, können Sie den Edge-optimierten benutzerdefinierten Domainnamen entfernen. Der folgende [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl entfernt den Edge-optimierten benutzerdefinierten Domänennamen:
```
aws apigateway update-domain-name \
--domain-name api.example.com \
--patch-operations '[
{"op":"remove", "path":"/endpointConfiguration/types", "value":"EDGE"},
{"op":"remove", "path":"certificateName"},
{"op":"remove", "path":"certificateArn"}
]'
```
------
Gehen Sie wie folgt vor, um einen regionalen benutzerdefinierten Domainnamen zu einem Edge-optimierten benutzerdefinierten Domainnamen zu migrieren.
------
#### [ AWS-Managementkonsole ]
1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway).
1. Klicken Sie im Hauptnavigationsbereich auf **Benutzerdefinierte Domainnamen**.
1. Wählen Sie einen benutzerdefinierten Domainnamen aus.
1. Klicken Sie unter **Endpunktkonfiguration** auf **Bearbeiten**.
1. Klicken Sie auf **Edge-optimierten Endpoint hinzufügen**.
1. Wählen Sie unter **ACM-Zertifikat** ein Zertifikat aus.
Das Zertifikat der Edge-optimierten Domäne muss in der Region `us-east-1` erstellt werden.
1. Wählen Sie **Speichern**.
1. Richten Sie einen DNS-Datensatz so ein, dass der Edge-optimierte benutzerdefinierte Domainname auf diesen Edge-optimierten Hostnamen verweist. Weitere Informationen finden Sie unter [Konfiguration von Route 53 zur Weiterleitung von Datenverkehr an API Gateway](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-api-gateway.html).
1. Nachdem Sie bestätigt haben, dass Ihre DNS-Konfiguration den richtigen Endpunkt verwendet, löschen Sie die regionale Endpunktkonfiguration. Wählen Sie Ihren benutzerdefinierten Domainnamen aus und klicken Sie dann unter **Konfiguration des regionalen Endpunkts** auf **Löschen**.
1. Bestätigen Sie Ihre Auswahl und löschen Sie den Endpunkt.
------
#### [ AWS CLI ]
Der folgende [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl migriert Ihren regionalen benutzerdefinierten Domainnamen zu einem Edge-optimierten benutzerdefinierten Domainnamen:
```
aws apigateway update-domain-name \
--domain-name 'api.example.com' \
--patch-operations '[
{ "op":"add", "path": "/endpointConfiguration/types","value": "EDGE" },
{ "op":"add", "path": "/certificateName", "value": "edge-cert" },
{"op":"add", "path": "/certificateArn", "value": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a"}
]'
```
Das Zertifikat der Edge-optimierten Domäne muss in der Region `us-east-1` erstellt werden.
Die Ausgabe sieht wie folgt aus:
```
{
"certificateArn": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a",
"certificateName": "edge-cert",
"certificateUploadDate": "2017-10-16T23:22:57Z",
"distributionDomainName": "d1frvgze7vy1bf.cloudfront.net",
"domainName": "api.example.com",
"endpointConfiguration": {
"types": [
"EDGE",
"REGIONAL"
]
},
"regionalCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/3d881b54-851a-478a-a887-f6502760461d",
"regionalDomainName": "d-cgkq2qwgzf.execute-api.us-east-1.amazonaws.com"
}
```
Für den angegebenen benutzerdefinierten Domänennamen gibt API Gateway den Edge-optimierten API-Hostnamen als Wert der Eigenschaft `distributionDomainName` zurück. Sie müssen einen DNS-Datensatz so einrichten, dass der Edge-optimierte benutzerdefinierte Domänenname auf diesen Verteilungsdomänennamen verweist. Auf diese Weise kann der Datenverkehr, der an den Edge-optimierten benutzerdefinierten Domänennamen gebunden ist, an den Edge-optimierten Hostnamen der API weitergeleitet werden.
Nachdem Sie den DNS-Datensatz eingerichtet haben, können Sie den Endpunkttyp `REGION` des benutzerdefinierten Domainnamens löschen. Mit dem folgenden [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html)Befehl wird der Endpunkttyp Regional entfernt:
```
aws apigateway update-domain-name \
--domain-name api.example.com \
--patch-operations '[
{"op":"remove", "path":"/endpointConfiguration/types", value:"REGIONAL"},
{"op":"remove", "path":"regionalCertificateArn"}
]'
```
Die Ausgabe sollte wie folgt aussehen:
```
{
"certificateArn": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a",
"certificateName": "edge-cert",
"certificateUploadDate": "2017-10-16T23:22:57Z",
"distributionDomainName": "d1frvgze7vy1bf.cloudfront.net",
"domainName": "api.example.com",
"endpointConfiguration": {
"types": "EDGE"
}
}
```
------