Beispiele für die Route-53-Domainregistrierung unter Verwendung von AWS CLI - AWS Command Line Interface

Beispiele für die Route-53-Domainregistrierung unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie das AWS Command Line Interface mit der Route-53-Domainregistrierung nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie check-domain-availability verwendet wird.

AWS CLI

So stellen Sie fest, ob Sie einen Domainnamen mit Route 53 registrieren können

Der folgende check-domain-availability-Befehl gibt Informationen darüber zurück, ob der Domainname example.com für die Registrierung über Route 53 verfügbar ist.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains check-domain-availability \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "Availability": "UNAVAILABLE" }

Route 53 unterstützt eine große Anzahl von Top-Level-Domains (TLDs), z. B. .com und .jp, wir unterstützen jedoch nicht alle verfügbaren TLDs. Wenn Sie die Verfügbarkeit einer Domain überprüfen und Route 53 die TLD nicht unterstützt, gibt check-domain-availability die folgende Meldung zurück.

An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: <top-level domain> tld is not supported.

Eine Liste der TLDs, die Sie bei einer Domainregistrierung mit Route 53 verwenden können, finden Sie unter Domains, die Sie mit Amazon Route 53 registrieren können im Entwicklerhandbuch zu Amazon Route 53. Weitere Informationen zum Registrieren einer Domain mit Route 53 finden Sie unter Registrieren einer neuen Domain im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie check-domain-transferability verwendet wird.

AWS CLI

So stellen Sie fest, ob eine Domain auf Route 53 übertragen werden kann

Der folgende check-domain-transferability-Befehl gibt Informationen darüber zurück, ob Sie den Domainnamen example.com auf Route 53 übertragen können.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains check-domain-transferability \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "Transferability": { "Transferable": "UNTRANSFERABLE" } }

Weitere Informationen finden Sie unter Übertragen der Registrierung für eine Domain an Amazon Route 53 im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie delete-tags-for-domain verwendet wird.

AWS CLI

So löschen Sie Tags für eine Domain

Der folgende delete-tags-for-domain-Befehl löscht drei Tags aus der angegebenen Domain. Beachten Sie, dass Sie nur den Tag-Schlüssel angeben, nicht den Tag-Wert.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains delete-tags-for-domain \ --region us-east-1 \ --domain-name example.com \ --tags-to-delete accounting-key hr-key engineering-key

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Sie können list-tags-for-domain ausführen, um zu bestätigen, dass die Tags gelöscht wurden. Weitere Informationen finden Sie unter Markieren von Amazon-Route-53-Ressourcen im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie disable-domain-auto-renew verwendet wird.

AWS CLI

So deaktivieren Sie die automatische Verlängerung für eine Domain

Mit dem folgenden disable-domain-auto-renew-Befehl wird Route 53 so konfiguriert, dass die Domain nicht automatisch die Domain-example.com erneuert, bevor die Registrierung für die Domain abläuft.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains disable-domain-auto-renew \ --region us-east-1 \ --domain-name example.com

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Sie können get-domain-detail ausführen, um zu bestätigen, dass die Einstellung geändert wurde. Wenn die automatische Verlängerung deaktiviert ist, ist der Wert AutoRenew False. Weitere Informationen zur automatischen Verlängerung finden Sie unter Erneuern der Registrierung für eine Domain <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie disable-domain-transfer-lock verwendet wird.

AWS CLI

So deaktivieren Sie die Übertragungssperre für eine Domain

Mit dem folgenden disable-domain-transfer-lock-Befehl wird die Übertragungssperre für die Domain example.com aufgehoben, sodass die Domain an einen anderen Registrar übertragen werden kann. Dieser Befehl ändert den clientTransferProhibited-Status.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains disable-domain-transfer-lock \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "OperationId": "3f28e0ac-126a-4113-9048-cc930example" }

Sie können get-domain-detail ausführen, um zu bestätigen, dass die Übertragungssperre aufgehoben wurde. Wenn die Übertragungssperre deaktiviert ist, schließt der Wert StatusList nicht clientTransferProhibited ein.

Weitere Informationen zum Übertragungsprozess finden Sie unter Übertragen einer Domain von Amazon Route 53 zu einer anderen Vergabestelle im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie enable-domain-auto-renew verwendet wird.

AWS CLI

So aktivieren Sie die automatische Verlängerung für eine Domain

Mit dem folgenden enable-domain-auto-renew-Befehl wird Route 53 so konfiguriert, dass die Domain automatisch die Domain example.com erneuert, bevor die Registrierung für die Domain abläuft.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains enable-domain-auto-renew \ --region us-east-1 \ --domain-name example.com

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Sie können get-domain-detail ausführen, um zu bestätigen, dass die Einstellung geändert wurde. Wenn die automatische Verlängerung aktiviert ist, ist der Wert AutoRenew True.

Weitere Informationen zur automatischen Verlängerung finden Sie unter Erneuern der Registrierung für eine Domain <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie enable-domain-transfer-lock verwendet wird.

AWS CLI

So aktivieren Sie die Übertragungssperre für eine Domain

Der folgende enable-domain-transfer-lock-Befehl sperrt die angegebene Domain, sodass sie nicht an eine andere Vergabestelle übertragen werden kann. Dieser Befehl ändert den clientTransferProhibited-Status.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains enable-domain-transfer-lock \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "OperationId": "3f28e0ac-126a-4113-9048-cc930example" }

Sie können get-domain-detail ausführen, um zu bestätigen, dass die Übertragungssperre aufgehoben wurde. Wenn die Übertragungssperre aktiviert ist, enthält der Wert von StatusList clientTransferProhibited.

Weitere Informationen zum Übertragungsprozess finden Sie unter Übertragen einer Domain von Amazon Route 53 zu einer anderen Vergabestelle im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie get-contact-reachability-status verwendet wird.

AWS CLI

So stellen Sie fest, ob der Kontakt der Vergabestelle auf eine Bestätigungs-E-Mail geantwortet hat

Der folgende get-contact-reachability-status-Befehl gibt Informationen darüber zurück, ob der Kontakt der Vergabestelle für die angegebene Domain auf eine Bestätigungs-E-Mail geantwortet hat.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains get-contact-reachability-status \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "domainName": "example.com", "status": "DONE" }

Weitere Informationen finden Sie unter Erneutes Senden von Autorisierungs- und Bestätigungs-E-Mails im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie get-domain-detail verwendet wird.

AWS CLI

So rufen Sie detaillierte Informationen zu einer bestimmten Domain ab

Der folgende get-domain-detail-Befehl zeigt detaillierte Informationen über die angegebene Domain an.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains get-domain-detail \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "DomainName": "example.com", "Nameservers": [ { "Name": "ns-2048.awsdns-64.com", "GlueIps": [] }, { "Name": "ns-2049.awsdns-65.net", "GlueIps": [] }, { "Name": "ns-2050.awsdns-66.org", "GlueIps": [] }, { "Name": "ns-2051.awsdns-67.co.uk", "GlueIps": [] } ], "AutoRenew": true, "AdminContact": { "FirstName": "Saanvi", "LastName": "Sarkar", "ContactType": "COMPANY", "OrganizationName": "Example", "AddressLine1": "123 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "ssarkar@example.com", "ExtraParams": [] }, "RegistrantContact": { "FirstName": "Alejandro", "LastName": "Rosalez", "ContactType": "COMPANY", "OrganizationName": "Example", "AddressLine1": "123 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "arosalez@example.com", "ExtraParams": [] }, "TechContact": { "FirstName": "Wang", "LastName": "Xiulan", "ContactType": "COMPANY", "OrganizationName": "Example", "AddressLine1": "123 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "wxiulan@example.com", "ExtraParams": [] }, "AdminPrivacy": true, "RegistrantPrivacy": true, "TechPrivacy": true, "RegistrarName": "Amazon Registrar, Inc.", "WhoIsServer": "whois.registrar.amazon", "RegistrarUrl": "http://registrar.amazon.com", "AbuseContactEmail": "abuse@registrar.amazon.com", "AbuseContactPhone": "+1.2062661000", "CreationDate": 1444934889.601, "ExpirationDate": 1602787689.0, "StatusList": [ "clientTransferProhibited" ] }
  • API-Details finden Sie unter GetDomainDetail in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-domain-suggestions verwendet wird.

AWS CLI

So rufen Sie eine Liste der vorgeschlagenen Domainnamen ab

Der folgende get-domain-suggestions-Befehl zeigt eine Liste mit vorgeschlagenen Domainnamen an, die auf dem Domainnamen example.com basieren. Die Antwort enthält nur verfügbare Domainnamen. Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains get-domain-suggestions \ --region us-east-1 \ --domain-name example.com \ --suggestion-count 10 \ --only-available

Ausgabe:

{ "SuggestionsList": [ { "DomainName": "egzaampal.com", "Availability": "AVAILABLE" }, { "DomainName": "examplelaw.com", "Availability": "AVAILABLE" }, { "DomainName": "examplehouse.net", "Availability": "AVAILABLE" }, { "DomainName": "homeexample.net", "Availability": "AVAILABLE" }, { "DomainName": "examplelist.com", "Availability": "AVAILABLE" }, { "DomainName": "examplenews.net", "Availability": "AVAILABLE" }, { "DomainName": "officeexample.com", "Availability": "AVAILABLE" }, { "DomainName": "exampleworld.com", "Availability": "AVAILABLE" }, { "DomainName": "exampleart.com", "Availability": "AVAILABLE" } ] }

Das folgende Codebeispiel zeigt, wie get-operation-detail verwendet wird.

AWS CLI

So rufen Sie den aktuellen Status einer Operation ab

Einige Domainregistrierungsvorgänge werden asynchron ausgeführt und geben eine Antwort zurück, bevor sie abgeschlossen sind. Diese Operationen geben eine Vorgangs-ID zurück, mit der Sie den aktuellen Status abrufen können. Der folgende get-operation-detail-Befehl gibt den Status des angegebenen Vorgangs zurück.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains get-operation-detail \ --region us-east-1 \ --operation-id edbd8d63-7fe7-4343-9bc5-54033example

Ausgabe:

{ "OperationId": "edbd8d63-7fe7-4343-9bc5-54033example", "Status": "SUCCESSFUL", "DomainName": "example.com", "Type": "DOMAIN_LOCK", "SubmittedDate": 1573749367.864 }

Das folgende Codebeispiel zeigt, wie list-domains verwendet wird.

AWS CLI

So listen Sie Domains auf, die mit dem aktuellen AWS-Konto registriert sind

Der folgende list-domains-Befehl listet zusammenfassende Informationen zu den Domains auf, die mit dem aktuellen AWS-Konto registriert sind:

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains list-domains --region us-east-1

Ausgabe:

{ "Domains": [ { "DomainName": "example.com", "AutoRenew": true, "TransferLock": true, "Expiry": 1602712345.0 }, { "DomainName": "example.net", "AutoRenew": true, "TransferLock": true, "Expiry": 1602723456.0 }, { "DomainName": "example.org", "AutoRenew": true, "TransferLock": true, "Expiry": 1602734567.0 } ] }
  • API-Details finden Sie unter ListDomains in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-operations verwendet wird.

AWS CLI

So listen Sie den Status von Vorgängen auf, die eine Vorgangs-ID zurückgeben

Einige Domainregistrierungsvorgänge werden asynchron ausgeführt und geben eine Antwort zurück, bevor sie abgeschlossen sind. Diese Operationen geben eine Vorgangs-ID zurück, mit der Sie den aktuellen Status abrufen können. Der folgende list-operations-Befehl listet zusammenfassende Informationen, einschließlich des Status, zu den aktuellen Domainregistrierungsvorgängen auf.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains list-operations --region us-east-1

Ausgabe:

{ "Operations": [ { "OperationId": "aab9822f-1da0-4bf3-8a15-fd4e0example", "Status": "SUCCESSFUL", "Type": "DOMAIN_LOCK", "SubmittedDate": 1455321739.986 }, { "OperationId": "c24379ed-76be-42f8-bdad-9379bexample", "Status": "SUCCESSFUL", "Type": "UPDATE_NAMESERVER", "SubmittedDate": 1468960475.109 }, { "OperationId": "f47e1297-ef9e-4c2b-ae1e-a5fcbexample", "Status": "SUCCESSFUL", "Type": "RENEW_DOMAIN", "SubmittedDate": 1473561835.943 }, { "OperationId": "75584f23-b15f-459e-aed7-dc6f5example", "Status": "SUCCESSFUL", "Type": "UPDATE_DOMAIN_CONTACT", "SubmittedDate": 1547501003.41 } ] }

Die Ausgabe umfasst alle Operationen, die eine Vorgangs-ID zurückgeben und die Sie für alle Domains ausgeführt haben, die Sie jemals mit dem aktuellen AWS-Konto registriert haben. Wenn Sie nur die Operationen abrufen möchten, die Sie nach einem bestimmten Datum eingereicht haben, können Sie den submitted-since-Parameter einbeziehen und ein Datum im Unix-Format und in koordinierter Weltzeit (UTC) angeben. Der folgende Befehl ruft den Status aller Operationen ab, die am 1. Januar 2020 nach 12:00 Uhr UTC gesendet wurden.

aws route53domains list-operations \ --submitted-since 1577836800
  • API-Details finden Sie unter ListOperations in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-domain verwendet wird.

AWS CLI

So listen Sie Tags für eine Domain auf

Der folgende list-tags-for-domain-Befehl listet die Tags auf, die derzeit der angegebenen Domain zugeordnet sind.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains list-tags-for-domain \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" } ] }

Weitere Informationen finden Sie unter Markieren von Amazon-Route-53-Ressourcen im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie register-domain verwendet wird.

AWS CLI

So registrieren Sie eine Domain

Der folgende register-domain-Befehl registriert eine Domain und ruft alle Parameterwerte aus einer Datei im JSON-Format ab.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains register-domain \ --region us-east-1 \ --cli-input-json file://register-domain.json

Inhalt von register-domain.json:

{ "DomainName": "example.com", "DurationInYears": 1, "AutoRenew": true, "AdminContact": { "FirstName": "Martha", "LastName": "Rivera", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "mrivera@example.com" }, "RegistrantContact": { "FirstName": "Li", "LastName": "Juan", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "ljuan@example.com" }, "TechContact": { "FirstName": "Mateo", "LastName": "Jackson", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "mjackson@example.com" }, "PrivacyProtectAdminContact": true, "PrivacyProtectRegistrantContact": true, "PrivacyProtectTechContact": true }

Ausgabe:

{ "OperationId": "b114c44a-9330-47d1-a6e8-a0b11example" }

Sie können get-operation-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation-detail.

Weitere Informationen finden Sie unter Registrieren einer neuen Domain im Entwicklerhandbuch zu Amazon Route 53.

Informationen darüber, für welche Top-Level-Domains (TLDs) Werte für ExtraParams erforderlich sind und welche Werte gültig sind, finden Sie unter ExtraParam in der API-Referenz zu Amazon Route 53.

  • API-Details finden Sie unter RegisterDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie renew-domain verwendet wird.

AWS CLI

So erneuern Sie eine Domain

Mit dem folgenden renew-domain-Befehl wird die angegebene Domain um fünf Jahre verlängert. Verwenden Sie den get-domain-detail-Befehl und konvertieren Sie den Wert von ExpirationDate aus dem Unix-Format, um den Wert für current-expiry-year abzurufen.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains renew-domain \ --region us-east-1 \ --domain-name example.com \ --duration-in-years 5 \ --current-expiry-year 2020

Ausgabe:

{ "OperationId": "3f28e0ac-126a-4113-9048-cc930example" }

Sie können get-operation-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation-detail.

Die Registrierung für jede Top-Level-Domain (TLD), z. B. .com oder .org, legt fest, für wie viele Jahre Sie eine Domain erneuern können. Informationen zum maximalen Verlängerungszeitraum für Ihre Domain finden Sie im Abschnitt „Registrierungs- und Verlängerungszeitraum“ für Ihre TLD unter Domains, die Sie mit Amazon Route 53 registrieren können im Entwicklerhandbuch zu Amazon Route 53.

Weitere Informationen finden Sie unter Verlängern der Registrierung für eine Domain im Entwicklerhandbuch zu Amazon Route 53.

  • API-Details finden Sie unter RenewDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie resend-contact-reachability-email verwendet wird.

AWS CLI

So senden Sie eine Bestätigungs-E-Mail an die aktuelle E-Mail-Adresse für den Registranten-Kontakt

Der folgende resend-contact-reachability-email-Befehl sendet die Bestätigungs-E-Mail erneut an die aktuelle E-Mail-Adresse des Registranten-Kontakts der Domain example.com.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains resend-contact-reachability-email \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "domainName": "example.com", "emailAddress": "moliveira@example.com", "isAlreadyVerified": true }

Wenn der Wert von isAlreadyVerified wie in diesem Bespiel true ist, hat der Registranten-Kontakt bereits bestätigt, dass die angegebene E-Mail-Adresse erreichbar ist.

Weitere Informationen finden Sie unter Erneutes Senden von Autorisierungs- und Bestätigungs-E-Mails im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie retrieve-domain-auth-code verwendet wird.

AWS CLI

So rufen Sie den Autorisierungscode für eine Domain ab, damit Sie die Domain an eine andere Vergabestelle übertragen können

Der folgende retrieve-domain-auth-code-Befehl ruft den aktuellen Autorisierungscode für die Domain example.com ab. Sie geben diesen Wert einer anderen Domain-Vergabestelle, wenn Sie die Domain an diese Vergabestelle übertragen möchten.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains retrieve-domain-auth-code \ --region us-east-1 \ --domain-name example.com

Ausgabe:

{ "AuthCode": ")o!v3dJeXampLe" }

Weitere Informationen finden Sie unter Übertragen einer Domain von Amazon Route 53 zu einer anderen Vergabestelle im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie transfer-domain verwendet wird.

AWS CLI

So übertragen Sie eine Domain an Amazon Route 53

Mit dem folgenden transfer-domain-Befehl wird eine Domain mit den in der JSON-formatierten Datei C:\temp\transfer-domain.json bereitgestellten Parametern an Route 53 übertragen.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains transfer-domain \ --region us-east-1 \ --cli-input-json file://C:\temp\transfer-domain.json

Inhalt von transfer-domain.json:

{ "DomainName": "example.com", "DurationInYears": 1, "Nameservers": [ { "Name": "ns-2048.awsdns-64.com" }, { "Name": "ns-2049.awsdns-65.net" }, { "Name": "ns-2050.awsdns-66.org" }, { "Name": "ns-2051.awsdns-67.co.uk" } ], "AuthCode": ")o!v3dJeXampLe", "AutoRenew": true, "AdminContact": { "FirstName": "Martha", "LastName": "Rivera", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "mrivera@example.com" }, "RegistrantContact": { "FirstName": "Li", "LastName": "Juan", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "ljuan@example.com" }, "TechContact": { "FirstName": "Mateo", "LastName": "Jackson", "ContactType": "PERSON", "OrganizationName": "Example", "AddressLine1": "1 Main Street", "City": "Anytown", "State": "WA", "CountryCode": "US", "ZipCode": "98101", "PhoneNumber": "+1.8005551212", "Email": "mjackson@example.com" }, "PrivacyProtectAdminContact": true, "PrivacyProtectRegistrantContact": true, "PrivacyProtectTechContact": true }

Ausgabe:

{ "OperationId": "b114c44a-9330-47d1-a6e8-a0b11example" }

Sie können get-operation-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation-detail.

Weitere Informationen finden Sie unter Übertragen der Registrierung für eine Domain an Amazon Route 53 im Entwicklerhandbuch zu Amazon Route 53.

  • API-Details finden Sie unter TransferDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-domain-contact-privacy verwendet wird.

AWS CLI

So aktualisieren Sie die Datenschutzeinstellungen für die Kontakte einer Domain

Mit dem folgenden update-domain-contact-privacy-Befehl wird der Datenschutz für den Administratorkontakt für die Domain example.com deaktiviert. Dieser Befehl wird nur in der us-east-1-Region ausgeführt.

Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains update-domain-contact-privacy \ --region us-east-1 \ --domain-name example.com \ --no-admin-privacy

Ausgabe:

{ "OperationId": "b3a219e9-d801-4244-b533-b7256example" }

Sie können get-operation-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation-detail.

Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren der automatischen Verlängerung für eine Domain im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie update-domain-contact verwendet wird.

AWS CLI

So aktualisieren Sie die Kontaktinformationen für eine Domain

Der folgende update-domain-contact-Befehl aktualisiert die Kontaktinformationen für eine Domain und ruft die Parameter aus der Datei C:\temp\update-domain-contact.json im JSON-Format ab.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains update-domain-contact \ --region us-east-1 \ --cli-input-json file://C:\temp\update-domain-contact.json

Inhalt von update-domain-contact.json:

{ "AdminContact": { "AddressLine1": "101 Main Street", "AddressLine2": "Suite 1a", "City": "Seattle", "ContactType": "COMPANY", "CountryCode": "US", "Email": "w.xiulan@example.com", "FirstName": "Wang", "LastName": "Xiulan", "OrganizationName": "Example", "PhoneNumber": "+1.8005551212", "State": "WA", "ZipCode": "98101" }, "DomainName": "example.com", "RegistrantContact": { "AddressLine1": "101 Main Street", "AddressLine2": "Suite 1a", "City": "Seattle", "ContactType": "COMPANY", "CountryCode": "US", "Email": "w.xiulan@example.com", "FirstName": "Wang", "LastName": "Xiulan", "OrganizationName": "Example", "PhoneNumber": "+1.8005551212", "State": "WA", "ZipCode": "98101" }, "TechContact": { "AddressLine1": "101 Main Street", "AddressLine2": "Suite 1a", "City": "Seattle", "ContactType": "COMPANY", "CountryCode": "US", "Email": "w.xiulan@example.com", "FirstName": "Wang", "LastName": "Xiulan", "OrganizationName": "Example", "PhoneNumber": "+1.8005551212", "State": "WA", "ZipCode": "98101" } }

Ausgabe:

{ "OperationId": "b3a219e9-d801-4244-b533-b7256example" }

Sie können get-domain-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter Aktualisieren der Kontaktinformationen für eine Domain im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie update-domain-nameservers verwendet wird.

AWS CLI

So aktualisieren Sie die Namenserver für eine Domain

Der folgende update-domain-nameservers-Befehl aktualisiert die Nameserver für eine Domain.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains update-domain-nameservers \ --region us-east-1 \ --domain-name example.com \ --nameservers Name=ns-1.awsdns-01.org Name=ns-2.awsdns-02.co.uk Name=ns-3.awsdns-03.net Name=ns-4.awsdns-04.com

Ausgabe:

{ "OperationId": "f1691ec4-0e7a-489e-82e0-b19d3example" }

Sie können get-domain-detail ausführen, um zu bestätigen, dass der Vorgang erfolgreich war.

Weitere Informationen finden Sie unter Hinzufügen oder Ändern der Namensserver und Glue-Datensätze in einer Domain im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie update-tags-for-domain verwendet wird.

AWS CLI

So fügen Sie Tags zu einer Domain hinzu oder aktualisieren sie

Mit dem folgenden update-tags-for-domain-Befehl werden zwei Schlüssel und die entsprechenden Werte für die Domain example.com hinzugefügt oder aktualisiert. Geben Sie einfach den Schlüssel und den neuen Wert an, um den Schlüsselwert zu aktualisieren. Sie können jeweils nur in einer Domain Tags hinzufügen oder aktualisieren.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains update-tags-for-domain \ --region us-east-1 \ --domain-name example.com \ --tags-to-update "Key=key1,Value=value1" "Key=key2,Value=value2"

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Sie können list-tags-for-domain ausführen, um zu bestätigen, dass die Tags hinzugefügt wurden.

Weitere Informationen finden Sie unter Markieren von Amazon-Route-53-Ressourcen im Entwicklerhandbuch zu Amazon Route 53.

Das folgende Codebeispiel zeigt, wie view-billing verwendet wird.

AWS CLI

So rufen Sie Rechnungsinformationen zu den Gebühren für die Domainregistrierung für das aktuelle AWS-Konto ab

Mit dem folgenden view-billing-Befehl werden alle domainbezogenen Abrechnungsdatensätze für das aktuelle Konto für den Zeitraum vom 1. Januar 2018 (1514764800 in Unix-Zeit) bis Mitternacht am 31. Dezember 2019 (1577836800 in Unix-Zeit) zurückgegeben.

Dieser Befehl wird nur in der us-east-1-Region ausgeführt. Wenn Ihre Standardregion auf us-east-1 gesetzt ist, können Sie den region-Parameter weglassen.

aws route53domains view-billing \ --region us-east-1 \ --start-time 1514764800 \ --end-time 1577836800

Ausgabe:

{ "BillingRecords": [ { "DomainName": "example.com", "Operation": "RENEW_DOMAIN", "InvoiceId": "149962827", "BillDate": 1536618063.181, "Price": 12.0 }, { "DomainName": "example.com", "Operation": "RENEW_DOMAIN", "InvoiceId": "290913289", "BillDate": 1568162630.884, "Price": 12.0 } ] }

Weitere Informationen finden Sie unter ViewBilling in der API-Referenz zu Amazon Route 53.

  • API-Details finden Sie unter ViewBilling in der AWS CLI-Befehlsreferenz.