Exemples d'enregistrement de domaines Route 53 à l'aide de AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant l'enregistrement de domaine AWS Command Line Interface avec Route 53.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

Actions

L'exemple de code suivant montre comment utilisercheck-domain-availability.

AWS CLI

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

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

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


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 (TLDs), tels que .com et.jp, mais nous ne prenons pas en charge tous les domaines disponiblesTLDs. Si vous vérifiez la disponibilité d'un domaine et que Route 53 ne le prend pas en chargeTLD, 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 domaines TLDs que vous pouvez utiliser lors de l'enregistrement d'un domaine auprès de Route 53, consultez la section Domaines que vous pouvez enregistrer auprès d'Amazon Route 53 dans le guide du développeur Amazon Route 53. Pour plus d'informations sur l'enregistrement de domaines auprès d'Amazon Route 53, consultez la section Enregistrer un nouveau domaine dans le manuel Amazon Route 53 Developer Guide.

Pour API plus de détails, voir CheckDomainAvailabilityla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercheck-domain-transferability.

AWS CLI

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

La check-domain-transferability commande 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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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

Sortie :


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

Pour plus d'informations, consultez la section Transfert de l'enregistrement d'un domaine vers Amazon Route 53 dans le manuel du développeur Amazon Route 53.

Pour API plus de détails, voir CheckDomainTransferabilityla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-tags-for-domain.

AWS CLI

Pour supprimer les balises d'un domaine

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

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


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 aucun résultat.

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

Pour API plus de détails, voir DeleteTagsForDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisable-domain-auto-renew.

AWS CLI

Pour désactiver le renouvellement automatique d'un domaine

La disable-domain-auto-renew commande 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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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

Cette commande ne produit aucun résultat.

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 estFalse. Pour plus d'informations sur le renouvellement automatique, consultez la section Renouvellement de l'enregistrement pour un domaine < https://docs.aws.amazon.com/Route53/ latest/ DeveloperGuide /domain-renew.html dans le manuel du développeur Amazon Route 53.

Pour API plus de détails, voir DisableDomainAutoRenewla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisable-domain-transfer-lock.

AWS CLI

Pour désactiver le verrouillage des transferts sur un domaine

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

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


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 verrou de transfert a été modifié, vous pouvez exécuter get-domain-detail. Lorsque le verrou de transfert est désactivé, la valeur de StatusList n'inclut pasclientTransferProhibited.

Pour plus d'informations sur le processus de transfert, consultez la section Transfert d'un domaine d'Amazon Route 53 vers un autre bureau d'enregistrement dans le guide du développeur Amazon Route 53.

Pour API plus de détails, voir DisableDomainTransferLockla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserenable-domain-auto-renew.

AWS CLI

Pour activer le renouvellement automatique d'un domaine

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

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


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

Cette commande ne produit aucun résultat. 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 estTrue.

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

Pour API plus de détails, voir EnableDomainAutoRenewla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserenable-domain-transfer-lock.

AWS CLI

Pour activer le verrouillage des transferts sur un domaine

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

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


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 verrou de transfert a été modifié, vous pouvez exécuter get-domain-detail. Lorsque le verrou de transfert est activé, la valeur de StatusList inclutclientTransferProhibited.

Pour API plus de détails, voir EnableDomainTransferLockla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-contact-reachability-status.

AWS CLI

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

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

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


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 la section Renvoyer des e-mails d'autorisation et de confirmation dans le guide du développeur Amazon Route 53.

Pour API plus de détails, voir GetContactReachabilityStatusla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-domain-detail.

AWS CLI

Pour obtenir des informations détaillées sur un domaine spécifique

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

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


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.com",
    "RegistrarUrl": "http://registrar.amazon.com",
    "AbuseContactEmail": "abuse@registrar.amazon.com",
    "AbuseContactPhone": "+1.2062661000",
    "CreationDate": 1444934889.601,
    "ExpirationDate": 1602787689.0,
    "StatusList": [
        "clientTransferProhibited"
    ]
}

Pour API plus de détails, voir GetDomainDetailla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-domain-suggestions.

AWS CLI

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

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


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 API plus de détails, voir GetDomainSuggestionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-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 identifiant d'opération que vous pouvez utiliser pour obtenir le statut actuel. La get-operation-detail commande suivante renvoie le statut de l'opération spécifiée.

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


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 API plus de détails, voir GetOperationDetailla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-domains.

AWS CLI

Pour répertorier les domaines enregistrés avec le AWS compte actuel

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

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


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 API plus de détails, voir ListDomainsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 s'exécutent de manière asynchrone et renvoient une réponse avant leur fin. Ces opérations renvoient un identifiant d'opération que vous pouvez utiliser pour obtenir le statut actuel. La list-operations commande suivante répertorie les 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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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 AWS compte courant. Si vous souhaitez obtenir uniquement les opérations que vous avez soumises après une date spécifiée, vous pouvez inclure le submitted-since paramètre 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 minuit le UTC 1er janvier 2020.


aws route53domains list-operations \
    --submitted-since 1577836800

Pour API plus de détails, voir ListOperationsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-domain.

AWS CLI

Pour répertorier les balises d'un domaine

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

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


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 la section Marquage des ressources Amazon Route 53 dans le manuel du développeur Amazon Route 53.

Pour API plus de détails, voir ListTagsForDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserregister-domain.

AWS CLI

Pour enregistrer un domaine

La register-domain commande suivante enregistre un domaine et récupère toutes les valeurs de paramètres d'un fichier JSON formaté.

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


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écuterget-operation-detail. Pour plus d'informations, consultez get-operation-detail.

Pour de plus amples informations, veuillez consulter Enregistrement d'un nouveau domaine dans le Manuel du développeur Amazon Route 53.

Pour plus d'informations sur les domaines de premier niveau (TLDs) nécessitant des valeurs ExtraParams et sur les valeurs valides, consultez le ExtraParammanuel Amazon Route 53 API Reference.

Pour API plus de détails, voir RegisterDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserrenew-domain.

AWS CLI

Pour renouveler un domaine

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

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


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écuterget-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 maximum d'années pour lesquelles vous pouvez renouveler un domaine. Pour connaître la période de renouvellement maximale pour votre domaine, consultez la section « Période d'enregistrement et de renouvellement » relative TLD aux domaines que vous pouvez enregistrer auprès d'Amazon Route 53 dans le guide du développeur Amazon Route 53.

Pour plus d'informations, consultez Renouveler l'enregistrement d'un domaine dans le manuel Amazon Route 53 Developer Guide.

Pour API plus de détails, voir RenewDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserresend-contact-reachability-email.

AWS CLI

Pour renvoyer l'e-mail de confirmation à l'adresse e-mail actuelle du titulaire, contactez

La resend-contact-reachability-email commande suivante renvoie l'e-mail de confirmation à l'adresse e-mail actuelle du contact du titulaire pour le domaine exemple.com.

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


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 isAlreadyVerified esttrue, comme dans cet exemple, le contact du titulaire a déjà confirmé que l'adresse e-mail spécifiée est joignable.

Pour plus d'informations, consultez la section Renvoyer des e-mails d'autorisation et de confirmation dans le guide du développeur Amazon Route 53.

Pour API plus de détails, voir ResendContactReachabilityEmailla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserretrieve-domain-auth-code.

AWS CLI

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

La retrieve-domain-auth-code commande suivante permet d'obtenir le code d'autorisation actuel pour le domaine exemple.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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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

Sortie :


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

Pour plus d'informations, consultez la section Transfert d'un domaine d'Amazon Route 53 vers un autre bureau d'enregistrement dans le guide du développeur Amazon Route 53.

Pour API plus de détails, voir RetrieveDomainAuthCodela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertransfer-domain.

AWS CLI

Pour transférer un domaine vers Amazon Route 53

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

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


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écuterget-operation-detail. Pour plus d'informations, consultez get-operation-detail.

Pour plus d'informations, consultez la section Transfert de l'enregistrement d'un domaine vers Amazon Route 53 dans le manuel du développeur Amazon Route 53.

Pour API plus de détails, voir TransferDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-domain-contact-privacy.

AWS CLI

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

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

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


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écuterget-operation-detail. Pour plus d'informations, consultez get-operation-detail.

Pour plus d'informations, consultez la section Activation ou désactivation de la protection de la confidentialité pour obtenir les coordonnées d'un domaine dans le guide du développeur Amazon Route 53.

Pour API plus de détails, voir UpdateDomainContactPrivacyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-domain-contact.

AWS CLI

Pour mettre à jour les informations de contact d'un domaine

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

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


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 la section Mise à jour des coordonnées d'un domaine dans le manuel Amazon Route 53 Developer Guide.

Pour API plus de détails, voir UpdateDomainContactla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-domain-nameservers.

AWS CLI

Pour mettre à jour les serveurs de noms d'un domaine

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

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


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 la section Ajouter ou modifier des serveurs de noms et des enregistrements Glue pour un domaine dans le manuel Amazon Route 53 Developer Guide.

Pour API plus de détails, voir UpdateDomainNameserversla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-tags-for-domain.

AWS CLI

Pour ajouter ou mettre à jour des balises pour un domaine

La update-tags-for-domain commande 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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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 aucun résultat. Pour vérifier que les balises ont été ajoutées ou mises à jour, vous pouvez exécuter list-tags-for-domain.

Pour plus d'informations, consultez la section Marquage des ressources Amazon Route 53 dans le manuel du développeur Amazon Route 53.

Pour API plus de détails, voir UpdateTagsForDomainla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserview-billing.

AWS CLI

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

La view-billing commande suivante renvoie tous les enregistrements de facturation relatifs au domaine pour le compte courant 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 us-east-1 région. Si votre région par défaut est définie surus-east-1, vous pouvez omettre le region paramètre.


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 ViewBillingla APIréférence Amazon Route 53.

Pour API plus de détails, voir ViewBillingla section Référence des AWS CLI commandes.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Route 53

Profils Route 53