使用 Route 53 的域名注册示例 AWS CLI

以下代码示例向您展示了如何在 Route 53 域注册中 AWS Command Line Interface 使用来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

操作

以下代码示例演示如何使用 check-domain-availability。

AWS CLI

确定是否可以使用 Route 53 注册域名

以下 check-domain-availability 命令返回有关域名 example.com 是否可以使用 Route 53 进行注册的信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


{
    "Availability": "UNAVAILABLE"
}

Route 53 支持大量顶级域 (TLDs)，例如.com和.jp，但我们不支持所有可用的域名TLDs。如果您检查某个域的可用性，而 Route 53 不支持TLD，check-domain-availability则会返回以下消息。


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

有关在 Route 53 注册域名时可以TLDs使用的列表，请参阅《亚马逊 Route 53 开发者指南》中的 “您可以在亚马逊 Route 53 上注册的域名”。有关使用 Amazon Route 53 注册域的更多信息，请参阅《Amazon Route 53 开发人员指南》中的注册新域。

有关API详细信息，请参阅 “CheckDomainAvailability AWS CLI命令参考”。

以下代码示例演示如何使用 check-domain-transferability。

AWS CLI

确定域是否可以转移到 Route 53

以下 check-domain-transferability 命令返回有关是否可以将域名 example.com 转移到 Route 53 的信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关更多信息，请参阅《Amazon Route 53 开发人员指南》中的将域的注册转移到 Amazon Route 53。

有关API详细信息，请参阅 “CheckDomainTransferability AWS CLI命令参考”。

以下代码示例演示如何使用 delete-tags-for-domain。

AWS CLI

删除域名的标签

以下delete-tags-for-domain命令从指定域中删除三个标签。请注意，您只能指定标签键，而不是标签值。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

此命令不生成任何输出。

要确认标签已删除，可以运行list-tags-for-domain。有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的为亚马逊 Route 53 资源添加标签。

有关API详细信息，请参阅 “DeleteTagsForDomain AWS CLI命令参考”。

以下代码示例演示如何使用 disable-domain-auto-renew。

AWS CLI

禁用域名的自动续订

以下disable-domain-auto-renew命令将 Route 53 配置为example.com在域注册到期之前不自动续订该域。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

此命令不生成任何输出。

要确认设置已更改，可以运行get-domain-detail。如果禁用了自动续订，则的值AutoRenew为False。有关自动续订的更多信息，请参阅 Amazon Route 53 开发者指南中的续订域名 < https://docs.aws.amazon.com/Route53/ latest/DeveloperGuide/domain-renew.html 的注册。

有关API详细信息，请参阅 “DisableDomainAutoRenew AWS CLI命令参考”。

以下代码示例演示如何使用 disable-domain-transfer-lock。

AWS CLI

禁用域名的转移锁定

以下disable-domain-transfer-lock命令可移除域名的转移锁定，example.com以便可以将域名转移到其他注册商。此命令更改clientTransferProhibited状态。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

要确认转移锁已更改，可以运行get-domain-detail。禁用转移锁时，的值StatusList不包括clientTransferProhibited。

有关转移流程的更多信息，请参阅《亚马逊 Route 53 开发者指南》中的将域名从 Amazon Route 53 转移到其他注册商。

有关API详细信息，请参阅 “DisableDomainTransferLock AWS CLI命令参考”。

以下代码示例演示如何使用 enable-domain-auto-renew。

AWS CLI

启用域名的自动续订

以下enable-domain-auto-renew命令将 Route 53 配置为example.com在域名注册到期之前自动续订该域。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

此命令不生成任何输出。要确认设置已更改，可以运行get-domain-detail。如果启用了自动续订，则的值AutoRenew为True。

有关自动续订的更多信息，请参阅 Amazon Route 53 开发者指南中的续订域名 < https://docs.aws.amazon.com/Route53/ latest/DeveloperGuide/domain-renew.html 的注册。

有关API详细信息，请参阅 “EnableDomainAutoRenew AWS CLI命令参考”。

以下代码示例演示如何使用 enable-domain-transfer-lock。

AWS CLI

在域名上启用转移锁定

以下enable-domain-transfer-lock命令会锁定指定的域，使其无法转移到其他注册商。此命令更改clientTransferProhibited状态。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

要确认转移锁已更改，可以运行get-domain-detail。启用转移锁定后，的值StatusList包括clientTransferProhibited。

有关转移流程的更多信息，请参阅《亚马逊 Route 53 开发者指南》中的将域名从 Amazon Route 53 转移到其他注册商。

有关API详细信息，请参阅 “EnableDomainTransferLock AWS CLI命令参考”。

以下代码示例演示如何使用 get-contact-reachability-status。

AWS CLI

确定注册人联系人是否已回复确认电子邮件

以下get-contact-reachability-status命令返回有关指定域名的注册人联系人是否已回复确认电子邮件的信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的重新发送授权和确认电子邮件。

有关API详细信息，请参阅 “GetContactReachabilityStatus AWS CLI命令参考”。

以下代码示例演示如何使用 get-domain-detail。

AWS CLI

获取有关指定域的详细信息

以下 get-domain-detail 命令显示有关指定域的详细信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关API详细信息，请参阅 “GetDomainDetail AWS CLI命令参考”。

以下代码示例演示如何使用 get-domain-suggestions。

AWS CLI

获取推荐域名列表

以下 get-domain-suggestions 命令根据域名显示推荐域名列表example.com。响应中仅包含可用的域名。此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关API详细信息，请参阅 “GetDomainSuggestions AWS CLI命令参考”。

以下代码示例演示如何使用 get-operation-detail。

AWS CLI

获取操作的当前状态

某些域注册操作是异步运行的，并在完成之前返回响应。这些操作会返回一个操作 ID，您可以借此获取其当前状态。以下 get-operation-detail 命令返回指定操作的状态。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关API详细信息，请参阅 “GetOperationDetail AWS CLI命令参考”。

以下代码示例演示如何使用 list-domains。

AWS CLI

列出使用当前 AWS 账户注册的域名

以下list-domains命令列出了有关在当前 AWS 账户中注册的域名的摘要信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


{
    "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详细信息，请参阅 “ListDomains AWS CLI命令参考”。

以下代码示例演示如何使用 list-operations。

AWS CLI

列出返回操作 ID 的操作的状态

某些域注册操作是异步运行的，并在完成之前返回响应。这些操作会返回一个操作 ID，您可以借此获取其当前状态。以下 list-operations 命令列出了有关当前域注册操作的状态等摘要信息。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

输出包括所有返回操作 ID 的操作，以及您在使用当前 AWS 账户注册的所有域名上执行的操作。如果您只想获取在指定日期之后提交的操作，则可以包含submitted-since参数并以 Unix 格式和协调世界时 (UTC) 指定日期。以下命令获取 2020 年 1 月 1 日UTC上午 12:00 之后提交的所有操作的状态。


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

有关API详细信息，请参阅 “ListOperations AWS CLI命令参考”。

以下代码示例演示如何使用 list-tags-for-domain。

AWS CLI

列出域名的标签

以下list-tags-for-domain命令列出了当前与指定域关联的标签。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关API详细信息，请参阅 “ListTagsForDomain AWS CLI命令参考”。

以下代码示例演示如何使用 register-domain。

AWS CLI

注册域

以下register-domain命令注册一个域，从JSON格式化文件中检索所有参数值。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

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
}

输出：


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

要确认操作是否成功，可以运行 get-operation-detail。有关更多信息，请参阅get-operation-detail。

有关更多信息，请参阅 Amazon Route 53 开发人员指南中的注册新域。

有关哪些顶级域 (TLDs) 需要值ExtraParams以及有效值的信息，请参阅ExtraParam《Amazon Route 53 API 参考》。

有关API详细信息，请参阅 “RegisterDomain AWS CLI命令参考”。

以下代码示例演示如何使用 renew-domain。

AWS CLI

续订域名

以下renew-domain命令将指定域名续订五年。要获取的值current-expiry-year，请使用get-domain-detail命令，然后ExpirationDate从 Unix 格式转换的值。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

要确认操作是否成功，可以运行 get-operation-detail。有关更多信息，请参阅get-operation-detail。

每个顶级域名 (TLD)（例如.com 或.org）的注册管理机构控制您可以续订域名的最大年数。要获取域名的最长续订期限，请参阅《亚马逊 Route 53 开发者指南》TLD中 “您可以在亚马逊 Route 53 注册的域名” 中的 “注册和续订期限” 部分。

有关更多信息，请参阅 Amazon Route 53 开发者指南中的续订域名注册。

有关API详细信息，请参阅 “RenewDomain AWS CLI命令参考”。

以下代码示例演示如何使用 resend-contact-reachability-email。

AWS CLI

要将确认电子邮件重新发送到注册人的当前电子邮件地址，请联系人

以下resend-contact-reachability-email命令将确认电子邮件重新发送到 example.com 域名注册人联系人的当前电子邮件地址。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

如果的值isAlreadyVerified为true，如本例所示，则注册人联系人已经确认可以访问指定的电子邮件地址。

有关更多信息，请参阅 Amazon Route 53 开发者指南中的重新发送授权和确认电子邮件。

有关API详细信息，请参阅 “ResendContactReachabilityEmail AWS CLI命令参考”。

以下代码示例演示如何使用 retrieve-domain-auth-code。

AWS CLI

获取域名的授权码，以便您可以将域名转移到其他注册商

以下retrieve-domain-auth-code命令获取 example.com 域名的当前授权码。当您想将域名转移给其他域名注册商时，您可以将此值提供给该注册商。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关API详细信息，请参阅 “RetrieveDomainAuthCode AWS CLI命令参考”。

以下代码示例演示如何使用 transfer-domain。

AWS CLI

将域名转移到亚马逊 Route 53

以下transfer-domain命令使用JSON格式文件C:\temp\transfer-domain.json提供的参数将域传输到 Route 53。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

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
}

输出：


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

要确认操作是否成功，可以运行 get-operation-detail。有关更多信息，请参阅get-operation-detail。

有关更多信息，请参阅《Amazon Route 53 开发人员指南》中的将域的注册转移到 Amazon Route 53。

有关API详细信息，请参阅 “TransferDomain AWS CLI命令参考”。

以下代码示例演示如何使用 update-domain-contact-privacy。

AWS CLI

更新域名联系人的隐私设置

以下update-domain-contact-privacy命令关闭 example.com 域名管理员联系人的隐私保护。此命令仅在 us-east-1 区域运行。

如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

要确认操作是否成功，可以运行 get-operation-detail。有关更多信息，请参阅get-operation-detail。

有关更多信息，请参阅 Amazon Route 53 开发者指南中的启用或禁用域名联系信息的隐私保护。

有关API详细信息，请参阅 “UpdateDomainContactPrivacy AWS CLI命令参考”。

以下代码示例演示如何使用 update-domain-contact。

AWS CLI

更新域名的联系信息

以下update-domain-contact命令更新域的联系人信息，从JSON格式化文件C:\temp\update-domain-contact.json中获取参数。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

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

输出：


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

要确认操作成功，可以运行get-domain-detail。有关更多信息，请参阅 Amazon Route 53 开发者指南中的更新域名的联系信息。

有关API详细信息，请参阅 “UpdateDomainContact AWS CLI命令参考”。

以下代码示例演示如何使用 update-domain-nameservers。

AWS CLI

更新域名的名称服务器

以下update-domain-nameservers命令更新域名的名称服务器。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 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

输出：


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

要确认操作成功，可以运行get-domain-detail。

有关更多信息，请参阅 Amazon Route 53 开发者指南中的添加或更改域名的名称服务器和 Glue 记录。

有关API详细信息，请参阅 “UpdateDomainNameservers AWS CLI命令参考”。

以下代码示例演示如何使用 update-tags-for-domain。

AWS CLI

为域名添加或更新标签

以下update-tags-for-domain命令添加或更新 example.com 域的两个密钥和相应值。要更新密钥的值，只需添加密钥和新值即可。一次只能在一个域中添加或更新标签。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 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"

此命令不生成任何输出。要确认标签已添加或更新，可以运行list-tags-for-domain。

有关API详细信息，请参阅 “UpdateTagsForDomain AWS CLI命令参考”。

以下代码示例演示如何使用 view-billing。

AWS CLI

获取当前 AWS 账户域名注册费用的账单信息

以下 view-billing 命令返回当前账户自 2018 年 1 月 1 日（Unix 时间为 1514764800）至 2019 年 12 月 31 日午夜（Unix 时间为 1577836800）期间的所有与域相关的账单记录。

此命令仅在 us-east-1 区域运行。如果默认区域设置为 us-east-1，则可以忽略 region 参数。


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

输出：


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

有关更多信息，请参阅ViewBilling《亚马逊 Route 53 API 参考》。

有关API详细信息，请参阅 “ViewBilling AWS CLI命令参考”。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

Route 53

Route 53 简介