Exemples d’utilisation de l’AWS CLI avec l’enregistrement de domaine Route 53 - AWS Command Line Interface

Exemples d’utilisation de l’AWS CLI avec l’enregistrement de domaine Route 53

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec l’enregistrement de domaine Route 53.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser check-domain-availability.

AWS CLI

Pour déterminer si vous pouvez enregistrer un nom de domaine avec Route 53

La commande check-domain-availability suivante renvoie des informations indiquant si le nom de domaine example.com est disponible pour être enregistré à l’aide de Route 53.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "Availability": "UNAVAILABLE" }

Route 53 prend en charge un grand nombre de domaines de premier niveau (TLD), tels que .com et .jp, mais nous ne prenons pas en charge tous les TLD disponibles. Si vous vérifiez la disponibilité d’un domaine et que Route 53 ne prend pas en charge le TLD, check-domain-availability renvoie le message suivant.

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

Pour obtenir la liste des TLD que vous pouvez utiliser lors de l’enregistrement d’un domaine avec Route 53, consultez Domaines que vous pouvez enregistrer avec Amazon Route 53 dans le Manuel du développeur Amazon Route 53. Pour plus d’informations sur l’enregistrement de domaines avec Amazon Route 53, consultez Enregistrement d’un nouveau domaine dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez CheckDomainAvailability dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser check-domain-transferability.

AWS CLI

Pour déterminer si un domaine peut être transféré vers Route 53

La commande check-domain-transferability suivante renvoie des informations indiquant si vous pouvez transférer le nom de domaine example.com vers Route 53.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour plus d’informations, consultez Transfert de l’enregistrement d’un domaine vers Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

L’exemple de code suivant montre comment utiliser delete-tags-for-domain.

AWS CLI

Pour supprimer les balises d’un domaine

La commande delete-tags-for-domain suivante supprime trois balises du domaine spécifié. Notez que vous ne spécifiez que la clé de balise, et non la valeur de la balise.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Cette commande ne produit aucune sortie.

Pour confirmer que les balises ont été supprimées, vous pouvez exécuter list-tags-for-domain. Pour plus d’informations, consultez Balisage des ressources Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez DeleteTagsForDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disable-domain-auto-renew.

AWS CLI

Pour désactiver le renouvellement automatique d’un domaine

La commande disable-domain-auto-renew suivante configure Route 53 pour ne pas renouveler automatiquement le domaine example.com avant l’expiration de son enregistrement.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Cette commande ne produit aucune sortie.

Pour confirmer que le paramètre a été modifié, vous pouvez exécuter get-domain-detail. Si le renouvellement automatique est désactivé, la valeur de AutoRenew est False. Pour plus d’informations sur le renouvellement automatique, consultez Renouvellement d’un enregistrement de domaine <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez DisableDomainAutoRenew dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disable-domain-transfer-lock.

AWS CLI

Pour désactiver le verrouillage du transfert sur un domaine

La commande disable-domain-transfer-lock suivante supprime le verrouillage du transfert sur le domaine example.com afin que celui-ci puisse être transféré vers un autre bureau d’enregistrement. Cette commande modifie le statut clientTransferProhibited.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour confirmer que le verrouillage du transfert a été modifié, vous pouvez exécuter get-domain-detail. Lorsque le verrouillage du transfert est désactivé, la valeur de StatusList n’inclut pas clientTransferProhibited.

Pour plus d’informations sur le processus de transfert, consultez Transfert d’un domaine depuis Amazon Route 53 vers un autre bureau d’enregistrement dans le Manuel du développeur Amazon Route 53.

L’exemple de code suivant montre comment utiliser enable-domain-auto-renew.

AWS CLI

Pour activer le renouvellement automatique d’un domaine

La commande enable-domain-auto-renew suivante configure Route 53 pour renouveler automatiquement le domaine example.com avant l’expiration de son enregistrement.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Cette commande ne produit aucune sortie. Pour confirmer que le paramètre a été modifié, vous pouvez exécuter get-domain-detail. Si le renouvellement automatique est activé, la valeur de AutoRenew est True.

Pour plus d’informations sur le renouvellement automatique, consultez Renouvellement d’un enregistrement de domaine <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez EnableDomainAutoRenew dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser enable-domain-transfer-lock.

AWS CLI

Pour activer le verrouillage du transfert sur un domaine

La commande enable-domain-transfer-lock verrouille le domaine spécifié afin que celui-ci ne puisse pas être transféré vers un autre bureau d’enregistrement. Cette commande modifie le statut clientTransferProhibited.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour confirmer que le verrouillage du transfert a été modifié, vous pouvez exécuter get-domain-detail. Lorsque le verrouillage du transfert est activé, la valeur de StatusList inclut clientTransferProhibited.

Pour plus d’informations sur le processus de transfert, consultez Transfert d’un domaine depuis Amazon Route 53 vers un autre bureau d’enregistrement dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez EnableDomainTransferLock dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-contact-reachability-status.

AWS CLI

Pour déterminer si le contact inscrit a répondu à un e-mail de confirmation

La commande get-contact-reachability-status suivante renvoie des informations indiquant si le contact inscrit pour le domaine spécifié a répondu à un e-mail de confirmation.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour plus d’informations, consultez Renvoi des e-mails de confirmation et d’autorisation dans le Manuel du développeur Amazon Route 53.

L’exemple de code suivant montre comment utiliser get-domain-detail.

AWS CLI

Pour obtenir les informations détaillées sur un domaine spécifié

La commande get-domain-detail suivante affiche des informations détaillées sur le domaine spécifié.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "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" ] }
  • Pour plus de détails sur l’API, consultez GetDomainDetail dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-domain-suggestions.

AWS CLI

Pour obtenir une liste de noms de domaine suggérés

La commande get-domain-suggestions suivante affiche une liste de noms de domaine suggérés en fonction du nom de domaine example.com. La réponse inclut uniquement les noms de domaine disponibles. Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "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" } ] }
  • Pour plus de détails sur l’API, consultez GetDomainSuggestions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-operation-detail.

AWS CLI

Pour obtenir le statut actuel d’une opération

Certaines opérations d’enregistrement de domaine fonctionnent de manière asynchrone et renvoient une réponse avant leur fin. Ces opérations renvoient un ID d’opération que vous pouvez utiliser pour obtenir le statut actuel. La commande get-operation-detail suivante renvoie le statut de l’opération spécifiée.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "OperationId": "edbd8d63-7fe7-4343-9bc5-54033example", "Status": "SUCCESSFUL", "DomainName": "example.com", "Type": "DOMAIN_LOCK", "SubmittedDate": 1573749367.864 }
  • Pour plus de détails sur l’API, consultez GetOperationDetail dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-domains.

AWS CLI

Pour créer une liste des domaines enregistrés avec le compte AWS actuel

La commande list-domains suivante répertorie des informations récapitulatives sur les domaines enregistrés avec le compte AWS actuel.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "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 } ] }
  • Pour plus de détails sur l’API, consultez ListDomains dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-operations.

AWS CLI

Pour répertorier le statut des opérations qui renvoient un ID d’opération

Certaines opérations d’enregistrement de domaine sont exécutées de manière asynchrone et renvoient une réponse avant leur fin. Ces opérations renvoient un ID d’opération que vous pouvez utiliser pour obtenir le statut actuel. La commande list-operations suivante crée une liste des informations récapitulatives, y compris le statut, concernant les opérations d’enregistrement de domaine en cours.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "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 } ] }

La sortie inclut toutes les opérations qui renvoient un ID d’opération et que vous avez effectuées sur tous les domaines que vous avez enregistrés à l’aide du compte AWS actuel. Si vous souhaitez obtenir uniquement les opérations que vous avez soumises après une date spécifiée, vous pouvez inclure le paramètre submitted-since et spécifier une date au format Unix et en temps universel coordonné (UTC). La commande suivante permet d’obtenir le statut de toutes les opérations soumises après 00h00 UTC le 1er janvier 2020.

aws route53domains list-operations \ --submitted-since 1577836800
  • Pour plus de détails sur l’API, consultez ListOperations dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-domain.

AWS CLI

Pour répertorier des balises pour un domaine

La commande list-tags-for-domain suivante répertorie les balises qui sont actuellement associées au domaine spécifié.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour plus d’informations, consultez Balisage des ressources Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez ListTagsForDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser register-domain.

AWS CLI

Pour enregistrer un domaine

La commande register-domain suivante enregistre un domaine et extrait toutes les valeurs de paramètres d’un fichier au format JSON.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Contenu de 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 }

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-operation-detail. Pour plus d’informations, consultez get-operation-detail.

Pour plus d’informations, consultez Enregistrement d’un nouveau domaine dans le Manuel du développeur Amazon Route 53.

Pour en savoir plus sur les domaines de premier niveau (TLD) nécessitant des valeurs pour ExtraParams et sur les valeurs valides, consultez ExtraParam dans la Référence des API d’Amazon Route 53.

  • Pour plus de détails sur l’API, consultez RegisterDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser renew-domain.

AWS CLI

Pour renouveler un domaine

La commande renew-domain suivante renouvelle le domaine spécifié pour cinq ans. Pour obtenir la valeur de current-expiry-year, utilisez la commande get-domain-detail et convertissez la valeur de ExpirationDate au format Unix.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-operation-detail. Pour plus d’informations, consultez get-operation-detail.

Le registre de chaque domaine de premier niveau (TLD), tel que .com ou .org, contrôle le nombre maximal d’années pour lequel vous pouvez renouveler un domaine. Pour connaître la période de renouvellement maximale pour votre domaine, consultez la section « Enregistrement et période de renouvellement » pour le TLD dans Domaines que vous pouvez enregistrer avec Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

Pour plus d’informations, consultez Renouvellement d’un enregistrement de domaine dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez RenewDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser resend-contact-reachability-email.

AWS CLI

Pour renvoyer l’e-mail de confirmation à l’adresse e-mail actuelle du contact inscrit

La commande resend-contact-reachability-email suivante renvoie l’e-mail de confirmation à l’adresse e-mail actuelle du contact inscrit pour le domaine example.com.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Si la valeur de isAlreadyVerified est true, comme dans cet exemple, le contact inscrit a déjà confirmé que l’adresse e-mail spécifiée est joignable.

Pour plus d’informations, consultez Renvoi des e-mails de confirmation et d’autorisation dans le Manuel du développeur Amazon Route 53.

L’exemple de code suivant montre comment utiliser retrieve-domain-auth-code.

AWS CLI

Pour obtenir le code d’autorisation d’un domaine afin de pouvoir transférer le domaine vers un autre bureau d’enregistrement

La commande retrieve-domain-auth-code suivante permet d’obtenir le code d’autorisation actuel du domaine example.com. Vous donnez cette valeur à un autre bureau d’enregistrement de domaine lorsque vous souhaitez transférer le domaine vers ce bureau d’enregistrement.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour plus d’informations, consultez Transfert d’un domaine depuis Amazon Route 53 vers un autre bureau d’enregistrement dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez RetrieveDomainAuthCode dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser transfer-domain.

AWS CLI

Pour transférer un domaine vers Amazon Route 53

La commande transfer-domain suivante transfère un domaine vers Route 53, avec les paramètres fournis par le fichier au format JSON C:\temp\transfer-domain.json.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Contenu de 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 }

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-operation-detail. Pour plus d’informations, consultez get-operation-detail.

Pour plus d’informations, consultez Transfert de l’enregistrement d’un domaine vers Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez TransferDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-domain-contact-privacy.

AWS CLI

Pour mettre à jour les paramètres de confidentialité des contacts pour un domaine

La commande update-domain-contact-privacy suivante désactive la protection de la confidentialité pour le contact administratif du domaine exemple.com. Cette commande s’exécute uniquement dans la région us-east-1.

Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-operation-detail. Pour plus d’informations, consultez get-operation-detail.

Pour plus d’informations, consultez Activation ou désactivation de la protection de la confidentialité pour les informations de contact pour un domaine dans le Manuel du développeur Amazon Route 53.

L’exemple de code suivant montre comment utiliser update-domain-contact.

AWS CLI

Pour mettre à jour les informations de contact pour un domaine

La commande update-domain-contact suivante met à jour les informations de contact pour un domaine en obtenant les paramètres à partir du fichier au format JSON C:\temp\update-domain-contact.json.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Contenu de 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" } }

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-domain-detail. Pour plus d’informations, consultez Mise à jour des informations de contact pour un domaine dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez UpdateDomainContact dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-domain-nameservers.

AWS CLI

Pour mettre à jour les serveurs de noms pour un domaine

La commande update-domain-nameservers suivante met à jour les serveurs de noms pour un domaine.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

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

Pour confirmer que l’opération a réussi, vous pouvez exécuter get-domain-detail.

Pour plus d’informations, consultez Ajout ou modification de serveurs de noms et d’enregistrements de type glue pour un domaine dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez UpdateDomainNameservers dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-tags-for-domain.

AWS CLI

Pour ajouter ou mettre à jour des balises pour un domaine

La commande update-tags-for-domain suivante ajoute ou met à jour deux clés et les valeurs correspondantes pour le domaine exemple.com. Pour mettre à jour la valeur d’une clé, il suffit d’inclure la clé et la nouvelle valeur. Vous ne pouvez ajouter ou mettre à jour des balises que dans un seul domaine à la fois.

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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"

Cette commande ne produit aucune sortie. Pour confirmer que les balises ont été ajoutées ou mises à jour, vous pouvez exécuter list-tags-for-domain.

Pour plus d’informations, consultez Balisage des ressources Amazon Route 53 dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez UpdateTagsForDomain dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser view-billing.

AWS CLI

Pour obtenir les informations de facturation relatives aux frais d’enregistrement de domaine pour le compte AWS actuel

La commande view-billing suivante renvoie tous les enregistrements de facturation relatifs au domaine pour le compte actuel pour la période comprise entre le 1er janvier 2018 (1514764800 en heure Unix) et minuit le 31 décembre 2019 (1577836800 en heure Unix).

Cette commande s’exécute uniquement dans la région us-east-1. Si la région par défaut est définie sur us-east-1, vous pouvez omettre le paramètre region.

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

Sortie :

{ "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 } ] }

Pour plus d’informations, consultez ViewBilling dans la Référence des API Amazon Route 53.

  • Pour plus de détails sur l’API, consultez ViewBilling dans la Référence des commandes de l’AWS CLI.