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

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

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

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

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

主题

操作

操作

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

Amazon 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 支持大量顶级域名 (TLD)，例如.com和.jp，但我们并不支持所有可用的顶级域名。如果您检查域名的可用性，而 Route 53 不支持该顶级域名，check-domain-availability则会返回以下消息。


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

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考CheckDomainAvailability中的。

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

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

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考CheckDomainTransferability中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考DeleteTagsForDomain中的。

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

Amazon 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。有关自动续订的更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 “续订域名注册 < https://docs.aws.amazon.com/Route53/latest/ DeveloperGuide /domain-renew.html”。

有关 API 的详细信息，请参阅Amazon CLI 命令参考DisableDomainAutoRenew中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考DisableDomainTransferLock中的。

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

Amazon 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。

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考EnableDomainAutoRenew中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考EnableDomainTransferLock中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考GetContactReachabilityStatus中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考GetDomainDetail中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考GetDomainSuggestions中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考GetOperationDetail中的。

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

Amazon CLI

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

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

此命令仅在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 的详细信息，请参阅Amazon CLI 命令参考ListDomains中的。

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

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


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

有关 API 的详细信息，请参阅Amazon CLI 命令参考ListOperations中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考ListTagsForDomain中的。

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

Amazon 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 开发者指南中的注册新域名。

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考RegisterDomain中的。

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

Amazon 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 开发者指南》中 “您可以在亚马逊 Route 53 注册的域名” 中的 TLD 的 “注册和续订期限” 部分。

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考RenewDomain中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考ResendContactReachabilityEmail中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考RetrieveDomainAuthCode中的。

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

Amazon CLI

将域名转移到亚马逊 Route 53

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

此命令仅在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。

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

有关 API 的详细信息，请参阅Amazon CLI 命令参考TransferDomain中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考UpdateDomainContactPrivacy中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考UpdateDomainContact中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考UpdateDomainNameservers中的。

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

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考UpdateTagsForDomain中的。

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

Amazon CLI

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

以下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 的详细信息，请参阅Amazon CLI 命令参考ViewBilling中的。

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

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

Route 53

Route 53 Resolver