本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Route 53 網域註冊使用 AWS SDKs程式碼範例
下列程式碼範例示範如何使用 Route 53 網域註冊搭配 AWS 軟體開發套件 (SDK)。
*基本概念*是程式碼範例，這些範例說明如何在服務內執行基本操作。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
**Contents**
+ [基本概念](service_code_examples_route-53-domains_basics.md)
+ [Hello Route 53 網域註冊](route-53-domains_example_route-53-domains_Hello_section.md)
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
+ [動作](service_code_examples_route-53-domains_actions.md)
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Route 53 網域註冊使用 AWS SDKs的基本範例
下列程式碼範例示範如何 Amazon Route 53 domain registration 搭配 AWS SDKs 使用 的基本概念。
**Contents**
+ [Hello Route 53 網域註冊](route-53-domains_example_route-53-domains_Hello_section.md)
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
+ [動作](service_code_examples_route-53-domains_actions.md)
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Hello Route 53 網域註冊
下列程式碼範例示範如何開始使用 Route 53 網域註冊。
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
public static class HelloRoute53Domains
{
static async Task Main(string[] args)
{
// Use the AWS .NET Core Setup package to set up dependency injection for the Amazon Route 53 domain registration service.
// Use your AWS profile name, or leave it blank to use the default profile.
using var host = Host.CreateDefaultBuilder(args)
.ConfigureServices((_, services) =>
services.AddAWSService()
).Build();
// Now the client is available for injection.
var route53Client = host.Services.GetRequiredService();
// You can use await and any of the async methods to get a response.
var response = await route53Client.ListPricesAsync(new ListPricesRequest { Tld = "com" });
Console.WriteLine($"Hello Amazon Route 53 Domains! Following are prices for .com domain operations:");
var comPrices = response.Prices.FirstOrDefault();
if (comPrices != null)
{
Console.WriteLine($"\tRegistration: {comPrices.RegistrationPrice?.Price} {comPrices.RegistrationPrice?.Currency}");
Console.WriteLine($"\tRenewal: {comPrices.RenewalPrice?.Price} {comPrices.RenewalPrice?.Currency}");
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.route53domains.Route53DomainsClient;
import software.amazon.awssdk.services.route53.model.Route53Exception;
import software.amazon.awssdk.services.route53domains.model.DomainPrice;
import software.amazon.awssdk.services.route53domains.model.ListPricesRequest;
import software.amazon.awssdk.services.route53domains.model.ListPricesResponse;
import java.util.List;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*
* This Java code examples performs the following operation:
*
* 1. Invokes ListPrices for at least one domain type, such as the “com” type
* and displays the prices for Registration and Renewal.
*
*/
public class HelloRoute53 {
public static final String DASHES = new String(new char[80]).replace("\0", "-");
public static void main(String[] args) {
final String usage = "\n" +
"Usage:\n" +
" \n\n" +
"Where:\n" +
" hostedZoneId - The id value of an existing hosted zone. \n";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String domainType = args[0];
Region region = Region.US_EAST_1;
Route53DomainsClient route53DomainsClient = Route53DomainsClient.builder()
.region(region)
.build();
System.out.println(DASHES);
System.out.println("Invokes ListPrices for at least one domain type.");
listPrices(route53DomainsClient, domainType);
System.out.println(DASHES);
}
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.maxItems(10)
.tld(domainType)
.build();
ListPricesResponse response = route53DomainsClient.listPrices(pricesRequest);
List prices = response.prices();
for (DomainPrice pr : prices) {
System.out.println("Name: " + pr.name());
System.out.println(
"Registration: " + pr.registrationPrice().price() + " " + pr.registrationPrice().currency());
System.out.println("Renewal: " + pr.renewalPrice().price() + " " + pr.renewalPrice().currency());
System.out.println("Transfer: " + pr.transferPrice().price() + " " + pr.transferPrice().currency());
System.out.println("Transfer: " + pr.transferPrice().price() + " " + pr.transferPrice().currency());
System.out.println("Change Ownership: " + pr.changeOwnershipPrice().price() + " "
+ pr.changeOwnershipPrice().currency());
System.out.println(
"Restoration: " + pr.restorationPrice().price() + " " + pr.restorationPrice().currency());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
/**
Before running this Kotlin code example, set up your development environment,
including your credentials.
For more information, see the following documentation topic:
https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/setup.html
*/
suspend fun main(args: Array) {
val usage = """
Usage:
Where:
domainType - The domain type (for example, com).
"""
if (args.size != 1) {
println(usage)
exitProcess(0)
}
val domainType = args[0]
println("Invokes ListPrices using a Paginated method.")
listPricesPaginated(domainType)
}
suspend fun listPricesPaginated(domainType: String) {
val pricesRequest =
ListPricesRequest {
maxItems = 10
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# 了解使用 AWS SDK 註冊 Route 53 網域的基本知識
下列程式碼範例示範如何：
+ 列出目前網域和過去一年的操作。
+ 檢視過去一年的帳單和網域類型對應的價格。
+ 取得網域建議。
+ 檢查網域的可用性和可轉移性。
+ 或者，要求網域註冊。
+ 取得操作詳細資訊。
+ 或者，取得網域詳細資訊。
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
在命令提示中執行互動式案例。
```
public static class Route53DomainScenario
{
/*
Before running this .NET code example, set up your development environment, including your credentials.
This .NET example performs the following tasks:
1. List current domains.
2. List operations in the past year.
3. View billing for the account in the past year.
4. View prices for domain types.
5. Get domain suggestions.
6. Check domain availability.
7. Check domain transferability.
8. Optionally, request a domain registration.
9. Get an operation detail.
10. Optionally, get a domain detail.
*/
private static Route53Wrapper _route53Wrapper = null!;
private static IConfiguration _configuration = null!;
static async Task Main(string[] args)
{
// Set up dependency injection for the Amazon service.
using var host = Host.CreateDefaultBuilder(args)
.ConfigureLogging(logging =>
logging.AddFilter("System", LogLevel.Debug)
.AddFilter("Microsoft", LogLevel.Information)
.AddFilter("Microsoft", LogLevel.Trace))
.ConfigureServices((_, services) =>
services.AddAWSService()
.AddTransient()
)
.Build();
_configuration = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("settings.json") // Load settings from .json file.
.AddJsonFile("settings.local.json",
true) // Optionally, load local settings.
.Build();
var logger = LoggerFactory.Create(builder =>
{
builder.AddConsole();
}).CreateLogger(typeof(Route53DomainScenario));
_route53Wrapper = host.Services.GetRequiredService();
Console.WriteLine(new string('-', 80));
Console.WriteLine("Welcome to the Amazon Route 53 domains example scenario.");
Console.WriteLine(new string('-', 80));
try
{
await ListDomains();
await ListOperations();
await ListBillingRecords();
await ListPrices();
await ListDomainSuggestions();
await CheckDomainAvailability();
await CheckDomainTransferability();
var operationId = await RequestDomainRegistration();
await GetOperationalDetail(operationId);
await GetDomainDetails();
}
catch (Exception ex)
{
logger.LogError(ex, "There was a problem executing the scenario.");
}
Console.WriteLine(new string('-', 80));
Console.WriteLine("The Amazon Route 53 domains example scenario is complete.");
Console.WriteLine(new string('-', 80));
}
///
/// List account registered domains.
///
/// Async task.
private static async Task ListDomains()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"1. List account domains.");
var domains = await _route53Wrapper.ListDomains();
for (int i = 0; i < domains.Count; i++)
{
Console.WriteLine($"\t{i + 1}. {domains[i].DomainName}");
}
if (!domains.Any())
{
Console.WriteLine("\tNo domains found in this account.");
}
Console.WriteLine(new string('-', 80));
}
///
/// List domain operations in the past year.
///
/// Async task.
private static async Task ListOperations()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"2. List account domain operations in the past year.");
var operations = await _route53Wrapper.ListOperations(
DateTime.Today.AddYears(-1));
for (int i = 0; i < operations.Count; i++)
{
Console.WriteLine($"\tOperation Id: {operations[i].OperationId}");
Console.WriteLine($"\tStatus: {operations[i].Status}");
Console.WriteLine($"\tDate: {operations[i].SubmittedDate}");
}
Console.WriteLine(new string('-', 80));
}
///
/// List billing in the past year.
///
/// Async task.
private static async Task ListBillingRecords()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"3. View billing for the account in the past year.");
var billingRecords = await _route53Wrapper.ViewBilling(
DateTime.Today.AddYears(-1),
DateTime.Today);
for (int i = 0; i < billingRecords.Count; i++)
{
Console.WriteLine($"\tBill Date: {billingRecords[i].BillDate.ToShortDateString()}");
Console.WriteLine($"\tOperation: {billingRecords[i].Operation}");
Console.WriteLine($"\tPrice: {billingRecords[i].Price}");
}
if (!billingRecords.Any())
{
Console.WriteLine("\tNo billing records found in this account for the past year.");
}
Console.WriteLine(new string('-', 80));
}
///
/// List prices for a few domain types.
///
/// Async task.
private static async Task ListPrices()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"4. View prices for domain types.");
var domainTypes = new List { "net", "com", "org", "co" };
var prices = await _route53Wrapper.ListPrices(domainTypes);
foreach (var pr in prices)
{
Console.WriteLine($"\tName: {pr.Name}");
Console.WriteLine($"\tRegistration: {pr.RegistrationPrice?.Price} {pr.RegistrationPrice?.Currency}");
Console.WriteLine($"\tRenewal: {pr.RenewalPrice?.Price} {pr.RenewalPrice?.Currency}");
Console.WriteLine($"\tTransfer: {pr.TransferPrice?.Price} {pr.TransferPrice?.Currency}");
Console.WriteLine($"\tChange Ownership: {pr.ChangeOwnershipPrice?.Price} {pr.ChangeOwnershipPrice?.Currency}");
Console.WriteLine($"\tRestoration: {pr.RestorationPrice?.Price} {pr.RestorationPrice?.Currency}");
Console.WriteLine();
}
Console.WriteLine(new string('-', 80));
}
///
/// List domain suggestions for a domain name.
///
/// Async task.
private static async Task ListDomainSuggestions()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"5. Get domain suggestions.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to get available domain suggestions.");
domainName = Console.ReadLine();
}
var suggestions = await _route53Wrapper.GetDomainSuggestions(domainName, true, 5);
foreach (var suggestion in suggestions)
{
Console.WriteLine($"\tSuggestion Name: {suggestion.DomainName}");
Console.WriteLine($"\tAvailability: {suggestion.Availability}");
}
Console.WriteLine(new string('-', 80));
}
///
/// Check availability for a domain name.
///
/// Async task.
private static async Task CheckDomainAvailability()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"6. Check domain availability.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to check domain availability.");
domainName = Console.ReadLine();
}
var availability = await _route53Wrapper.CheckDomainAvailability(domainName);
Console.WriteLine($"\tAvailability: {availability}");
Console.WriteLine(new string('-', 80));
}
///
/// Check transferability for a domain name.
///
/// Async task.
private static async Task CheckDomainTransferability()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"7. Check domain transferability.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to check domain transferability.");
domainName = Console.ReadLine();
}
var transferability = await _route53Wrapper.CheckDomainTransferability(domainName);
Console.WriteLine($"\tTransferability: {transferability}");
Console.WriteLine(new string('-', 80));
}
///
/// Check transferability for a domain name.
///
/// Async task.
private static async Task RequestDomainRegistration()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"8. Optionally, request a domain registration.");
Console.WriteLine($"\tNote: This example uses domain request settings in settings.json.");
Console.WriteLine($"\tTo change the domain registration settings, set the values in that file.");
Console.WriteLine($"\tRemember, registering an actual domain will incur an account billing cost.");
Console.WriteLine($"\tWould you like to begin a domain registration? (y/n)");
var ynResponse = Console.ReadLine();
if (ynResponse != null && ynResponse.Equals("y", StringComparison.InvariantCultureIgnoreCase))
{
string domainName = _configuration["DomainName"];
ContactDetail contact = new ContactDetail();
contact.CountryCode = CountryCode.FindValue(_configuration["Contact:CountryCode"]);
contact.ContactType = ContactType.FindValue(_configuration["Contact:ContactType"]);
_configuration.GetSection("Contact").Bind(contact);
var operationId = await _route53Wrapper.RegisterDomain(
domainName,
Convert.ToBoolean(_configuration["AutoRenew"]),
Convert.ToInt32(_configuration["DurationInYears"]),
contact);
if (operationId != null)
{
Console.WriteLine(
$"\tRegistration requested. Operation Id: {operationId}");
}
return operationId;
}
Console.WriteLine(new string('-', 80));
return null;
}
///
/// Get details for an operation.
///
/// Async task.
private static async Task GetOperationalDetail(string? operationId)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"9. Get an operation detail.");
var operationDetails =
await _route53Wrapper.GetOperationDetail(operationId);
Console.WriteLine(operationDetails);
Console.WriteLine(new string('-', 80));
}
///
/// Optionally, get details for a registered domain.
///
/// Async task.
private static async Task GetDomainDetails()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"10. Get details on a domain.");
Console.WriteLine($"\tNote: you must have a registered domain to get details.");
Console.WriteLine($"\tWould you like to get domain details? (y/n)");
var ynResponse = Console.ReadLine();
if (ynResponse != null && ynResponse.Equals("y", StringComparison.InvariantCultureIgnoreCase))
{
string? domainName = null;
while (domainName == null)
{
Console.WriteLine($"\tEnter a domain name to get details.");
domainName = Console.ReadLine();
}
var domainDetails = await _route53Wrapper.GetDomainDetail(domainName);
Console.WriteLine(domainDetails);
}
Console.WriteLine(new string('-', 80));
return null;
}
}
```
Route 53 網域註冊動作案例使用的包裝函式方式。
```
public class Route53Wrapper
{
private readonly IAmazonRoute53Domains _amazonRoute53Domains;
private readonly ILogger _logger;
public Route53Wrapper(IAmazonRoute53Domains amazonRoute53Domains, ILogger logger)
{
_amazonRoute53Domains = amazonRoute53Domains;
_logger = logger;
}
///
/// List prices for domain type operations.
///
/// Domain types to include in the results.
/// The list of domain prices.
public async Task> ListPrices(List domainTypes)
{
var results = new List();
var paginatePrices = _amazonRoute53Domains.Paginators.ListPrices(new ListPricesRequest());
// Get the entire list using the paginator.
await foreach (var prices in paginatePrices.Prices)
{
results.Add(prices);
}
return results.Where(p => domainTypes.Contains(p.Name)).ToList();
}
///
/// Check the availability of a domain name.
///
/// The domain to check for availability.
/// An availability result string.
public async Task CheckDomainAvailability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainAvailabilityAsync(
new CheckDomainAvailabilityRequest
{
DomainName = domain
}
);
return result.Availability.Value;
}
///
/// Check the transferability of a domain name.
///
/// The domain to check for transferability.
/// A transferability result string.
public async Task CheckDomainTransferability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainTransferabilityAsync(
new CheckDomainTransferabilityRequest
{
DomainName = domain
}
);
return result.Transferability.Transferable.Value;
}
///
/// Get a list of suggestions for a given domain.
///
/// The domain to check for suggestions.
/// If true, only returns available domains.
/// The number of suggestions to return. Defaults to the max of 50.
/// A collection of domain suggestions.
public async Task> GetDomainSuggestions(string domain, bool onlyAvailable, int suggestionCount = 50)
{
var result = await _amazonRoute53Domains.GetDomainSuggestionsAsync(
new GetDomainSuggestionsRequest
{
DomainName = domain,
OnlyAvailable = onlyAvailable,
SuggestionCount = suggestionCount
}
);
return result.SuggestionsList;
}
///
/// Get details for a domain action operation.
///
/// The operational Id.
/// A string describing the operational details.
public async Task GetOperationDetail(string? operationId)
{
if (operationId == null)
return "Unable to get operational details because ID is null.";
try
{
var operationDetails =
await _amazonRoute53Domains.GetOperationDetailAsync(
new GetOperationDetailRequest
{
OperationId = operationId
}
);
var details = $"\tOperation {operationId}:\n" +
$"\tFor domain {operationDetails.DomainName} on {operationDetails.SubmittedDate.ToShortDateString()}.\n" +
$"\tMessage is {operationDetails.Message}.\n" +
$"\tStatus is {operationDetails.Status}.\n";
return details;
}
catch (AmazonRoute53DomainsException ex)
{
return $"Unable to get operation details. Here's why: {ex.Message}.";
}
}
///
/// Initiate a domain registration request.
///
/// Contact details.
/// The domain name to register.
/// True if the domain should automatically renew.
/// The duration in years for the domain registration.
/// The operation Id.
public async Task RegisterDomain(string domainName, bool autoRenew, int duration, ContactDetail contact)
{
// This example uses the same contact information for admin, registrant, and tech contacts.
try
{
var result = await _amazonRoute53Domains.RegisterDomainAsync(
new RegisterDomainRequest()
{
AdminContact = contact,
RegistrantContact = contact,
TechContact = contact,
DomainName = domainName,
AutoRenew = autoRenew,
DurationInYears = duration,
PrivacyProtectAdminContact = false,
PrivacyProtectRegistrantContact = false,
PrivacyProtectTechContact = false
}
);
return result.OperationId;
}
catch (InvalidInputException)
{
_logger.LogInformation($"Unable to request registration for domain {domainName}");
return null;
}
}
///
/// View billing records for the account between a start and end date.
///
/// The start date for billing results.
/// The end date for billing results.
/// A collection of billing records.
public async Task> ViewBilling(DateTime startDate, DateTime endDate)
{
var results = new List();
var paginateBilling = _amazonRoute53Domains.Paginators.ViewBilling(
new ViewBillingRequest()
{
Start = startDate,
End = endDate
});
// Get the entire list using the paginator.
await foreach (var billingRecords in paginateBilling.BillingRecords)
{
results.Add(billingRecords);
}
return results;
}
///
/// List the domains for the account.
///
/// A collection of domain summary records.
public async Task> ListDomains()
{
var results = new List();
var paginateDomains = _amazonRoute53Domains.Paginators.ListDomains(
new ListDomainsRequest());
// Get the entire list using the paginator.
await foreach (var domain in paginateDomains.Domains)
{
results.Add(domain);
}
return results;
}
///
/// List operations for the account that are submitted after a specified date.
///
/// A collection of operation summary records.
public async Task> ListOperations(DateTime submittedSince)
{
var results = new List();
var paginateOperations = _amazonRoute53Domains.Paginators.ListOperations(
new ListOperationsRequest()
{
SubmittedSince = submittedSince
});
// Get the entire list using the paginator.
await foreach (var operations in paginateOperations.Operations)
{
results.Add(operations);
}
return results;
}
///
/// Get details for a domain.
///
/// A string with detail information about the domain.
public async Task GetDomainDetail(string domainName)
{
try
{
var result = await _amazonRoute53Domains.GetDomainDetailAsync(
new GetDomainDetailRequest()
{
DomainName = domainName
});
var details = $"\tDomain {domainName}:\n" +
$"\tCreated on {result.CreationDate.ToShortDateString()}.\n" +
$"\tAdmin contact is {result.AdminContact.Email}.\n" +
$"\tAuto-renew is {result.AutoRenew}.\n";
return details;
}
catch (InvalidInputException)
{
return $"Domain {domainName} was not found in your account.";
}
}
}
```
+ 如需 API 詳細資訊，請參閱《*適用於 .NET 的 AWS SDK API 參考*》中的下列主題。
+ [CheckDomainAvailability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainAvailability)
+ [CheckDomainTransferability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainTransferability)
+ [GetDomainDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainDetail)
+ [GetDomainSuggestions](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainSuggestions)
+ [GetOperationDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetOperationDetail)
+ [ListDomains](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListDomains)
+ [ListOperations](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListOperations)
+ [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)
+ [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain)
+ [ViewBilling](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ViewBilling)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*
* This example uses pagination methods where applicable. For example, to list
* domains, the
* listDomainsPaginator method is used. For more information about pagination,
* see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/pagination.html
*
* This Java code example performs the following operations:
*
* 1. List current domains.
* 2. List operations in the past year.
* 3. View billing for the account in the past year.
* 4. View prices for domain types.
* 5. Get domain suggestions.
* 6. Check domain availability.
* 7. Check domain transferability.
* 8. Request a domain registration.
* 9. Get operation details.
* 10. Optionally, get domain details.
*/
public class Route53Scenario {
public static final String DASHES = new String(new char[80]).replace("\0", "-");
public static void main(String[] args) {
final String usage = """
Usage:
Where:
domainType - The domain type (for example, com).\s
phoneNumber - The phone number to use (for example, +91.9966564xxx) email - The email address to use. domainSuggestion - The domain suggestion (for example, findmy.accountants).\s
firstName - The first name to use to register a domain.\s
lastName - The last name to use to register a domain.\s
city - the city to use to register a domain.\s
""";
if (args.length != 7) {
System.out.println(usage);
System.exit(1);
}
String domainType = args[0];
String phoneNumber = args[1];
String email = args[2];
String domainSuggestion = args[3];
String firstName = args[4];
String lastName = args[5];
String city = args[6];
Region region = Region.US_EAST_1;
Route53DomainsClient route53DomainsClient = Route53DomainsClient.builder()
.region(region)
.build();
System.out.println(DASHES);
System.out.println("Welcome to the Amazon Route 53 domains example scenario.");
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("1. List current domains.");
listDomains(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("2. List operations in the past year.");
listOperations(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("3. View billing for the account in the past year.");
listBillingRecords(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("4. View prices for domain types.");
listPrices(route53DomainsClient, domainType);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("5. Get domain suggestions.");
listDomainSuggestions(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("6. Check domain availability.");
checkDomainAvailability(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("7. Check domain transferability.");
checkDomainTransferability(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("8. Request a domain registration.");
String opId = requestDomainRegistration(route53DomainsClient, domainSuggestion, phoneNumber, email, firstName,
lastName, city);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("9. Get operation details.");
getOperationalDetail(route53DomainsClient, opId);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("10. Get domain details.");
System.out.println("Note: You must have a registered domain to get details.");
System.out.println("Otherwise, an exception is thrown that states ");
System.out.println("Domain xxxxxxx not found in xxxxxxx account.");
getDomainDetails(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
}
public static void getDomainDetails(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainDetailRequest detailRequest = GetDomainDetailRequest.builder()
.domainName(domainSuggestion)
.build();
GetDomainDetailResponse response = route53DomainsClient.getDomainDetail(detailRequest);
System.out.println("The contact first name is " + response.registrantContact().firstName());
System.out.println("The contact last name is " + response.registrantContact().lastName());
System.out.println("The contact org name is " + response.registrantContact().organizationName());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void getOperationalDetail(Route53DomainsClient route53DomainsClient, String operationId) {
try {
GetOperationDetailRequest detailRequest = GetOperationDetailRequest.builder()
.operationId(operationId)
.build();
GetOperationDetailResponse response = route53DomainsClient.getOperationDetail(detailRequest);
System.out.println("Operation detail message is " + response.message());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static String requestDomainRegistration(Route53DomainsClient route53DomainsClient,
String domainSuggestion,
String phoneNumber,
String email,
String firstName,
String lastName,
String city) {
try {
ContactDetail contactDetail = ContactDetail.builder()
.contactType(ContactType.COMPANY)
.state("LA")
.countryCode(CountryCode.IN)
.email(email)
.firstName(firstName)
.lastName(lastName)
.city(city)
.phoneNumber(phoneNumber)
.organizationName("My Org")
.addressLine1("My Address")
.zipCode("123 123")
.build();
RegisterDomainRequest domainRequest = RegisterDomainRequest.builder()
.adminContact(contactDetail)
.registrantContact(contactDetail)
.techContact(contactDetail)
.domainName(domainSuggestion)
.autoRenew(true)
.durationInYears(1)
.build();
RegisterDomainResponse response = route53DomainsClient.registerDomain(domainRequest);
System.out.println("Registration requested. Operation Id: " + response.operationId());
return response.operationId();
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
return "";
}
public static void checkDomainTransferability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainTransferabilityRequest transferabilityRequest = CheckDomainTransferabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainTransferabilityResponse response = route53DomainsClient
.checkDomainTransferability(transferabilityRequest);
System.out.println("Transferability: " + response.transferability().transferable().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void checkDomainAvailability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainAvailabilityRequest availabilityRequest = CheckDomainAvailabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainAvailabilityResponse response = route53DomainsClient
.checkDomainAvailability(availabilityRequest);
System.out.println(domainSuggestion + " is " + response.availability().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listDomainSuggestions(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainSuggestionsRequest suggestionsRequest = GetDomainSuggestionsRequest.builder()
.domainName(domainSuggestion)
.suggestionCount(5)
.onlyAvailable(true)
.build();
GetDomainSuggestionsResponse response = route53DomainsClient.getDomainSuggestions(suggestionsRequest);
List suggestions = response.suggestionsList();
for (DomainSuggestion suggestion : suggestions) {
System.out.println("Suggestion Name: " + suggestion.domainName());
System.out.println("Availability: " + suggestion.availability());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.tld(domainType)
.build();
ListPricesIterable listRes = route53DomainsClient.listPricesPaginator(pricesRequest);
listRes.stream()
.flatMap(r -> r.prices().stream())
.forEach(content -> System.out.println(" Name: " + content.name() +
" Registration: " + content.registrationPrice().price() + " "
+ content.registrationPrice().currency() +
" Renewal: " + content.renewalPrice().price() + " " + content.renewalPrice().currency()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listBillingRecords(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
LocalDateTime localDateTime2 = localDateTime.minusYears(1);
Instant myStartTime = localDateTime2.toInstant(zoneOffset);
Instant myEndTime = localDateTime.toInstant(zoneOffset);
ViewBillingRequest viewBillingRequest = ViewBillingRequest.builder()
.start(myStartTime)
.end(myEndTime)
.build();
ViewBillingIterable listRes = route53DomainsClient.viewBillingPaginator(viewBillingRequest);
listRes.stream()
.flatMap(r -> r.billingRecords().stream())
.forEach(content -> System.out.println(" Bill Date:: " + content.billDate() +
" Operation: " + content.operationAsString() +
" Price: " + content.price()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listOperations(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
localDateTime = localDateTime.minusYears(1);
Instant myTime = localDateTime.toInstant(zoneOffset);
ListOperationsRequest operationsRequest = ListOperationsRequest.builder()
.submittedSince(myTime)
.build();
ListOperationsIterable listRes = route53DomainsClient.listOperationsPaginator(operationsRequest);
listRes.stream()
.flatMap(r -> r.operations().stream())
.forEach(content -> System.out.println(" Operation Id: " + content.operationId() +
" Status: " + content.statusAsString() +
" Date: " + content.submittedDate()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listDomains(Route53DomainsClient route53DomainsClient) {
try {
ListDomainsIterable listRes = route53DomainsClient.listDomainsPaginator();
listRes.stream()
.flatMap(r -> r.domains().stream())
.forEach(content -> System.out.println("The domain name is " + content.domainName()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
}
```
+ 如需 API 詳細資訊，請參閱《*AWS SDK for Java 2.x API 參考*》中的下列主題。
+ [CheckDomainAvailability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainAvailability)
+ [CheckDomainTransferability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainTransferability)
+ [GetDomainDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainDetail)
+ [GetDomainSuggestions](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainSuggestions)
+ [GetOperationDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetOperationDetail)
+ [ListDomains](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListDomains)
+ [ListOperations](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations)
+ [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)
+ [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain)
+ [ViewBilling](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ViewBilling)
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
/**
Before running this Kotlin code example, set up your development environment,
including your credentials.
For more information, see the following documentation topic:
https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/setup.html
This Kotlin code example performs the following operations:
1. List current domains.
2. List operations in the past year.
3. View billing for the account in the past year.
4. View prices for domain types.
5. Get domain suggestions.
6. Check domain availability.
7. Check domain transferability.
8. Request a domain registration.
9. Get operation details.
10. Optionally, get domain details.
*/
val DASHES: String = String(CharArray(80)).replace("\u0000", "-")
suspend fun main(args: Array) {
val usage = """
Usage:
Where:
domainType - The domain type (for example, com).
phoneNumber - The phone number to use (for example, +1.2065550100)
email - The email address to use.
domainSuggestion - The domain suggestion (for example, findmy.example).
firstName - The first name to use to register a domain.
lastName - The last name to use to register a domain.
city - The city to use to register a domain.
"""
if (args.size != 7) {
println(usage)
exitProcess(1)
}
val domainType = args[0]
val phoneNumber = args[1]
val email = args[2]
val domainSuggestion = args[3]
val firstName = args[4]
val lastName = args[5]
val city = args[6]
println(DASHES)
println("Welcome to the Amazon Route 53 domains example scenario.")
println(DASHES)
println(DASHES)
println("1. List current domains.")
listDomains()
println(DASHES)
println(DASHES)
println("2. List operations in the past year.")
listOperations()
println(DASHES)
println(DASHES)
println("3. View billing for the account in the past year.")
listBillingRecords()
println(DASHES)
println(DASHES)
println("4. View prices for domain types.")
listAllPrices(domainType)
println(DASHES)
println(DASHES)
println("5. Get domain suggestions.")
listDomainSuggestions(domainSuggestion)
println(DASHES)
println(DASHES)
println("6. Check domain availability.")
checkDomainAvailability(domainSuggestion)
println(DASHES)
println(DASHES)
println("7. Check domain transferability.")
checkDomainTransferability(domainSuggestion)
println(DASHES)
println(DASHES)
println("8. Request a domain registration.")
val opId = requestDomainRegistration(domainSuggestion, phoneNumber, email, firstName, lastName, city)
println(DASHES)
println(DASHES)
println("9. Get operation details.")
getOperationalDetail(opId)
println(DASHES)
println(DASHES)
println("10. Get domain details.")
println("Note: You must have a registered domain to get details.")
println("Otherwise an exception is thrown that states ")
println("Domain xxxxxxx not found in xxxxxxx account.")
getDomainDetails(domainSuggestion)
println(DASHES)
}
suspend fun getDomainDetails(domainSuggestion: String?) {
val detailRequest =
GetDomainDetailRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainDetail(detailRequest)
println("The contact first name is ${response.registrantContact?.firstName}")
println("The contact last name is ${response.registrantContact?.lastName}")
println("The contact org name is ${response.registrantContact?.organizationName}")
}
}
suspend fun getOperationalDetail(opId: String?) {
val detailRequest =
GetOperationDetailRequest {
operationId = opId
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getOperationDetail(detailRequest)
println("Operation detail message is ${response.message}")
}
}
suspend fun requestDomainRegistration(
domainSuggestion: String?,
phoneNumberVal: String?,
emailVal: String?,
firstNameVal: String?,
lastNameVal: String?,
cityVal: String?,
): String? {
val contactDetail =
ContactDetail {
contactType = ContactType.Company
state = "LA"
countryCode = CountryCode.In
email = emailVal
firstName = firstNameVal
lastName = lastNameVal
city = cityVal
phoneNumber = phoneNumberVal
organizationName = "My Org"
addressLine1 = "My Address"
zipCode = "123 123"
}
val domainRequest =
RegisterDomainRequest {
adminContact = contactDetail
registrantContact = contactDetail
techContact = contactDetail
domainName = domainSuggestion
autoRenew = true
durationInYears = 1
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.registerDomain(domainRequest)
println("Registration requested. Operation Id: ${response.operationId}")
return response.operationId
}
}
suspend fun checkDomainTransferability(domainSuggestion: String?) {
val transferabilityRequest =
CheckDomainTransferabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainTransferability(transferabilityRequest)
println("Transferability: ${response.transferability?.transferable}")
}
}
suspend fun checkDomainAvailability(domainSuggestion: String) {
val availabilityRequest =
CheckDomainAvailabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainAvailability(availabilityRequest)
println("$domainSuggestion is ${response.availability}")
}
}
suspend fun listDomainSuggestions(domainSuggestion: String?) {
val suggestionsRequest =
GetDomainSuggestionsRequest {
domainName = domainSuggestion
suggestionCount = 5
onlyAvailable = true
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainSuggestions(suggestionsRequest)
response.suggestionsList?.forEach { suggestion ->
println("Suggestion Name: ${suggestion.domainName}")
println("Availability: ${suggestion.availability}")
println(" ")
}
}
}
suspend fun listAllPrices(domainType: String?) {
val pricesRequest =
ListPricesRequest {
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
suspend fun listBillingRecords() {
val currentDate = Date()
val localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
val localDateTime2 = localDateTime.minusYears(1)
val myStartTime = localDateTime2.toInstant(zoneOffset)
val myEndTime = localDateTime.toInstant(zoneOffset)
val timeStart: Instant? = myStartTime?.let { Instant(it) }
val timeEnd: Instant? = myEndTime?.let { Instant(it) }
val viewBillingRequest =
ViewBillingRequest {
start = timeStart
end = timeEnd
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.viewBillingPaginated(viewBillingRequest)
.transform { it.billingRecords?.forEach { obj -> emit(obj) } }
.collect { billing ->
println("Bill Date: ${billing.billDate}")
println("Operation: ${billing.operation}")
println("Price: ${billing.price}")
}
}
}
suspend fun listOperations() {
val currentDate = Date()
var localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
localDateTime = localDateTime.minusYears(1)
val myTime: java.time.Instant? = localDateTime.toInstant(zoneOffset)
val time2: Instant? = myTime?.let { Instant(it) }
val operationsRequest =
ListOperationsRequest {
submittedSince = time2
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listOperationsPaginated(operationsRequest)
.transform { it.operations?.forEach { obj -> emit(obj) } }
.collect { content ->
println("Operation Id: ${content.operationId}")
println("Status: ${content.status}")
println("Date: ${content.submittedDate}")
}
}
}
suspend fun listDomains() {
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listDomainsPaginated(ListDomainsRequest {})
.transform { it.domains?.forEach { obj -> emit(obj) } }
.collect { content ->
println("The domain name is ${content.domainName}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《*AWS SDK for Kotlin API 參考*》中的下列主題。
+ [CheckDomainAvailability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [CheckDomainTransferability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetDomainDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetDomainSuggestions](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetOperationDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListDomains](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListOperations](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ViewBilling](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# Route 53 網域註冊使用 AWS SDKs的動作
下列程式碼範例示範如何使用 AWS SDKs 執行個別 Route 53 網域註冊動作。每個範例均包含 GitHub 的連結，您可以在連結中找到設定和執行程式碼的相關說明。
下列範例僅包含最常使用的動作。如需完整清單，請參閱《[Amazon Route 53 domain registration API 參考](https://docs.aws.amazon.com/Route53/latest/APIReference/API_Operations_Amazon_Route_53_Domains.html)》。
**Topics**
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# `CheckDomainAvailability` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `CheckDomainAvailability`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Check the availability of a domain name.
///
/// The domain to check for availability.
/// An availability result string.
public async Task CheckDomainAvailability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainAvailabilityAsync(
new CheckDomainAvailabilityRequest
{
DomainName = domain
}
);
return result.Availability.Value;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [CheckDomainAvailability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainAvailability)。
------
#### [ CLI ]
**AWS CLI**
**判斷您是否可以使用 Route 53 註冊網域名稱**
下列 `check-domain-availability` 命令會傳回有關是否可以使用 Route 53 註冊網域名稱 `example.com` 的資訊。
此命令僅在 `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`，但我們不支援所有可用的 TLD。如果您檢查網域的可用性，且 Route 53 不支援 TLD，則 `check-domain-availability` 會傳回下列訊息。
```
An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: tld is not supported.
```
如需可用來向 Route 53 註冊網域的 TLD 清單，請參閱《Amazon Route 53 開發人員指南》**中的[可向 Amazon Route 53 註冊的網域](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html)。如需使用 Amazon Route 53 註冊網域的詳細資訊，請參閱《Amazon Route 53 開發人員指南》**中的[註冊新網域](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CheckDomainAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-availability.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void checkDomainAvailability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainAvailabilityRequest availabilityRequest = CheckDomainAvailabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainAvailabilityResponse response = route53DomainsClient
.checkDomainAvailability(availabilityRequest);
System.out.println(domainSuggestion + " is " + response.availability().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [CheckDomainAvailability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainAvailability)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun checkDomainAvailability(domainSuggestion: String) {
val availabilityRequest =
CheckDomainAvailabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainAvailability(availabilityRequest)
println("$domainSuggestion is ${response.availability}")
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [CheckDomainAvailability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `CheckDomainTransferability` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `CheckDomainTransferability`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Check the transferability of a domain name.
///
/// The domain to check for transferability.
/// A transferability result string.
public async Task CheckDomainTransferability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainTransferabilityAsync(
new CheckDomainTransferabilityRequest
{
DomainName = domain
}
);
return result.Transferability.Transferable.Value;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [CheckDomainTransferability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainTransferability)。
------
#### [ CLI ]
**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](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CheckDomainTransferability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-transferability.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void checkDomainTransferability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainTransferabilityRequest transferabilityRequest = CheckDomainTransferabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainTransferabilityResponse response = route53DomainsClient
.checkDomainTransferability(transferabilityRequest);
System.out.println("Transferability: " + response.transferability().transferable().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [CheckDomainTransferability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainTransferability)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun checkDomainTransferability(domainSuggestion: String?) {
val transferabilityRequest =
CheckDomainTransferabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainTransferability(transferabilityRequest)
println("Transferability: ${response.transferability?.transferable}")
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [CheckDomainTransferability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `GetDomainDetail` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `GetDomainDetail`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Get details for a domain.
///
/// A string with detail information about the domain.
public async Task GetDomainDetail(string domainName)
{
try
{
var result = await _amazonRoute53Domains.GetDomainDetailAsync(
new GetDomainDetailRequest()
{
DomainName = domainName
});
var details = $"\tDomain {domainName}:\n" +
$"\tCreated on {result.CreationDate.ToShortDateString()}.\n" +
$"\tAdmin contact is {result.AdminContact.Email}.\n" +
$"\tAuto-renew is {result.AutoRenew}.\n";
return details;
}
catch (InvalidInputException)
{
return $"Domain {domainName} was not found in your account.";
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [GetDomainDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainDetail)。
------
#### [ CLI ]
**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",
"RegistrarUrl": "http://registrar.amazon.com",
"AbuseContactEmail": "abuse@registrar.amazon.com",
"AbuseContactPhone": "+1.2062661000",
"CreationDate": 1444934889.601,
"ExpirationDate": 1602787689.0,
"StatusList": [
"clientTransferProhibited"
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetDomainDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-detail.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void getDomainDetails(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainDetailRequest detailRequest = GetDomainDetailRequest.builder()
.domainName(domainSuggestion)
.build();
GetDomainDetailResponse response = route53DomainsClient.getDomainDetail(detailRequest);
System.out.println("The contact first name is " + response.registrantContact().firstName());
System.out.println("The contact last name is " + response.registrantContact().lastName());
System.out.println("The contact org name is " + response.registrantContact().organizationName());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [GetDomainDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainDetail)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun getDomainDetails(domainSuggestion: String?) {
val detailRequest =
GetDomainDetailRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainDetail(detailRequest)
println("The contact first name is ${response.registrantContact?.firstName}")
println("The contact last name is ${response.registrantContact?.lastName}")
println("The contact org name is ${response.registrantContact?.organizationName}")
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [GetDomainDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `GetDomainSuggestions` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `GetDomainSuggestions`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Get a list of suggestions for a given domain.
///
/// The domain to check for suggestions.
/// If true, only returns available domains.
/// The number of suggestions to return. Defaults to the max of 50.
/// A collection of domain suggestions.
public async Task> GetDomainSuggestions(string domain, bool onlyAvailable, int suggestionCount = 50)
{
var result = await _amazonRoute53Domains.GetDomainSuggestionsAsync(
new GetDomainSuggestionsRequest
{
DomainName = domain,
OnlyAvailable = onlyAvailable,
SuggestionCount = suggestionCount
}
);
return result.SuggestionsList;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [GetDomainSuggestions](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainSuggestions)。
------
#### [ CLI ]
**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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetDomainSuggestions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-suggestions.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void listDomainSuggestions(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainSuggestionsRequest suggestionsRequest = GetDomainSuggestionsRequest.builder()
.domainName(domainSuggestion)
.suggestionCount(5)
.onlyAvailable(true)
.build();
GetDomainSuggestionsResponse response = route53DomainsClient.getDomainSuggestions(suggestionsRequest);
List suggestions = response.suggestionsList();
for (DomainSuggestion suggestion : suggestions) {
System.out.println("Suggestion Name: " + suggestion.domainName());
System.out.println("Availability: " + suggestion.availability());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [GetDomainSuggestions](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainSuggestions)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun listDomainSuggestions(domainSuggestion: String?) {
val suggestionsRequest =
GetDomainSuggestionsRequest {
domainName = domainSuggestion
suggestionCount = 5
onlyAvailable = true
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainSuggestions(suggestionsRequest)
response.suggestionsList?.forEach { suggestion ->
println("Suggestion Name: ${suggestion.domainName}")
println("Availability: ${suggestion.availability}")
println(" ")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [GetDomainSuggestions](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `GetOperationDetail` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `GetOperationDetail`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Get details for a domain action operation.
///
/// The operational Id.
/// A string describing the operational details.
public async Task GetOperationDetail(string? operationId)
{
if (operationId == null)
return "Unable to get operational details because ID is null.";
try
{
var operationDetails =
await _amazonRoute53Domains.GetOperationDetailAsync(
new GetOperationDetailRequest
{
OperationId = operationId
}
);
var details = $"\tOperation {operationId}:\n" +
$"\tFor domain {operationDetails.DomainName} on {operationDetails.SubmittedDate.ToShortDateString()}.\n" +
$"\tMessage is {operationDetails.Message}.\n" +
$"\tStatus is {operationDetails.Status}.\n";
return details;
}
catch (AmazonRoute53DomainsException ex)
{
return $"Unable to get operation details. Here's why: {ex.Message}.";
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [GetOperationDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetOperationDetail)。
------
#### [ CLI ]
**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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetOperationDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-operation-detail.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void getOperationalDetail(Route53DomainsClient route53DomainsClient, String operationId) {
try {
GetOperationDetailRequest detailRequest = GetOperationDetailRequest.builder()
.operationId(operationId)
.build();
GetOperationDetailResponse response = route53DomainsClient.getOperationDetail(detailRequest);
System.out.println("Operation detail message is " + response.message());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [GetOperationDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetOperationDetail)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun getOperationalDetail(opId: String?) {
val detailRequest =
GetOperationDetailRequest {
operationId = opId
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getOperationDetail(detailRequest)
println("Operation detail message is ${response.message}")
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [GetOperationDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `ListDomains` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `ListDomains`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// List the domains for the account.
///
/// A collection of domain summary records.
public async Task> ListDomains()
{
var results = new List();
var paginateDomains = _amazonRoute53Domains.Paginators.ListDomains(
new ListDomainsRequest());
// Get the entire list using the paginator.
await foreach (var domain in paginateDomains.Domains)
{
results.Add(domain);
}
return results;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [ListDomains](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListDomains)。
------
#### [ CLI ]
**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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-domains.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void listDomains(Route53DomainsClient route53DomainsClient) {
try {
ListDomainsIterable listRes = route53DomainsClient.listDomainsPaginator();
listRes.stream()
.flatMap(r -> r.domains().stream())
.forEach(content -> System.out.println("The domain name is " + content.domainName()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ListDomains](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListDomains)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun listDomains() {
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listDomainsPaginated(ListDomainsRequest {})
.transform { it.domains?.forEach { obj -> emit(obj) } }
.collect { content ->
println("The domain name is ${content.domainName}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [ListDomains](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `ListOperations` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `ListOperations`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// List operations for the account that are submitted after a specified date.
///
/// A collection of operation summary records.
public async Task> ListOperations(DateTime submittedSince)
{
var results = new List();
var paginateOperations = _amazonRoute53Domains.Paginators.ListOperations(
new ListOperationsRequest()
{
SubmittedSince = submittedSince
});
// Get the entire list using the paginator.
await foreach (var operations in paginateOperations.Operations)
{
results.Add(operations);
}
return results;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》[https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListOperations](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListOperations)中的 *ListOperations*。
------
#### [ CLI ]
**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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-operations.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void listOperations(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
localDateTime = localDateTime.minusYears(1);
Instant myTime = localDateTime.toInstant(zoneOffset);
ListOperationsRequest operationsRequest = ListOperationsRequest.builder()
.submittedSince(myTime)
.build();
ListOperationsIterable listRes = route53DomainsClient.listOperationsPaginator(operationsRequest);
listRes.stream()
.flatMap(r -> r.operations().stream())
.forEach(content -> System.out.println(" Operation Id: " + content.operationId() +
" Status: " + content.statusAsString() +
" Date: " + content.submittedDate()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》[https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations)中的 *ListOperations*。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun listOperations() {
val currentDate = Date()
var localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
localDateTime = localDateTime.minusYears(1)
val myTime: java.time.Instant? = localDateTime.toInstant(zoneOffset)
val time2: Instant? = myTime?.let { Instant(it) }
val operationsRequest =
ListOperationsRequest {
submittedSince = time2
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listOperationsPaginated(operationsRequest)
.transform { it.operations?.forEach { obj -> emit(obj) } }
.collect { content ->
println("Operation Id: ${content.operationId}")
println("Status: ${content.status}")
println("Date: ${content.submittedDate}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [ListOperations](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `ListPrices` 搭配 AWS SDK 使用
下列程式碼範例示範如何使用 `ListPrices`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// List prices for domain type operations.
///
/// Domain types to include in the results.
/// The list of domain prices.
public async Task> ListPrices(List domainTypes)
{
var results = new List();
var paginatePrices = _amazonRoute53Domains.Paginators.ListPrices(new ListPricesRequest());
// Get the entire list using the paginator.
await foreach (var prices in paginatePrices.Prices)
{
results.Add(prices);
}
return results.Where(p => domainTypes.Contains(p.Name)).ToList();
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.tld(domainType)
.build();
ListPricesIterable listRes = route53DomainsClient.listPricesPaginator(pricesRequest);
listRes.stream()
.flatMap(r -> r.prices().stream())
.forEach(content -> System.out.println(" Name: " + content.name() +
" Registration: " + content.registrationPrice().price() + " "
+ content.registrationPrice().currency() +
" Renewal: " + content.renewalPrice().price() + " " + content.renewalPrice().currency()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun listAllPrices(domainType: String?) {
val pricesRequest =
ListPricesRequest {
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `RegisterDomain` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `RegisterDomain`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// Initiate a domain registration request.
///
/// Contact details.
/// The domain name to register.
/// True if the domain should automatically renew.
/// The duration in years for the domain registration.
/// The operation Id.
public async Task RegisterDomain(string domainName, bool autoRenew, int duration, ContactDetail contact)
{
// This example uses the same contact information for admin, registrant, and tech contacts.
try
{
var result = await _amazonRoute53Domains.RegisterDomainAsync(
new RegisterDomainRequest()
{
AdminContact = contact,
RegistrantContact = contact,
TechContact = contact,
DomainName = domainName,
AutoRenew = autoRenew,
DurationInYears = duration,
PrivacyProtectAdminContact = false,
PrivacyProtectRegistrantContact = false,
PrivacyProtectTechContact = false
}
);
return result.OperationId;
}
catch (InvalidInputException)
{
_logger.LogInformation($"Unable to request registration for domain {domainName}");
return null;
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain)。
------
#### [ CLI ]
**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](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html)。
如需詳細資訊，請參閱《Amazon Route 53 開發人員指南》**中的[註冊新網域](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html)。
如需哪些頂層網域 (TLD) 需要 `ExtraParams` 的值和有效值的相關資訊，請參閱《Amazon Route 53 API 參考》**中的 [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static String requestDomainRegistration(Route53DomainsClient route53DomainsClient,
String domainSuggestion,
String phoneNumber,
String email,
String firstName,
String lastName,
String city) {
try {
ContactDetail contactDetail = ContactDetail.builder()
.contactType(ContactType.COMPANY)
.state("LA")
.countryCode(CountryCode.IN)
.email(email)
.firstName(firstName)
.lastName(lastName)
.city(city)
.phoneNumber(phoneNumber)
.organizationName("My Org")
.addressLine1("My Address")
.zipCode("123 123")
.build();
RegisterDomainRequest domainRequest = RegisterDomainRequest.builder()
.adminContact(contactDetail)
.registrantContact(contactDetail)
.techContact(contactDetail)
.domainName(domainSuggestion)
.autoRenew(true)
.durationInYears(1)
.build();
RegisterDomainResponse response = route53DomainsClient.registerDomain(domainRequest);
System.out.println("Registration requested. Operation Id: " + response.operationId());
return response.operationId();
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
return "";
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun requestDomainRegistration(
domainSuggestion: String?,
phoneNumberVal: String?,
emailVal: String?,
firstNameVal: String?,
lastNameVal: String?,
cityVal: String?,
): String? {
val contactDetail =
ContactDetail {
contactType = ContactType.Company
state = "LA"
countryCode = CountryCode.In
email = emailVal
firstName = firstNameVal
lastName = lastNameVal
city = cityVal
phoneNumber = phoneNumberVal
organizationName = "My Org"
addressLine1 = "My Address"
zipCode = "123 123"
}
val domainRequest =
RegisterDomainRequest {
adminContact = contactDetail
registrantContact = contactDetail
techContact = contactDetail
domainName = domainSuggestion
autoRenew = true
durationInYears = 1
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.registerDomain(domainRequest)
println("Registration requested. Operation Id: ${response.operationId}")
return response.operationId
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
# `ViewBilling` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `ViewBilling`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples)中設定和執行。
```
///
/// View billing records for the account between a start and end date.
///
/// The start date for billing results.
/// The end date for billing results.
/// A collection of billing records.
public async Task> ViewBilling(DateTime startDate, DateTime endDate)
{
var results = new List();
var paginateBilling = _amazonRoute53Domains.Paginators.ViewBilling(
new ViewBillingRequest()
{
Start = startDate,
End = endDate
});
// Get the entire list using the paginator.
await foreach (var billingRecords in paginateBilling.BillingRecords)
{
results.Add(billingRecords);
}
return results;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [ViewBilling](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ViewBilling)。
------
#### [ CLI ]
**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
}
]
}
```
如需詳細資訊，請參閱《Amazon Route 53 API 參考》**中的 [ViewBilling](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ViewBilling.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ViewBilling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/view-billing.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples)中設定和執行。
```
public static void listBillingRecords(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
LocalDateTime localDateTime2 = localDateTime.minusYears(1);
Instant myStartTime = localDateTime2.toInstant(zoneOffset);
Instant myEndTime = localDateTime.toInstant(zoneOffset);
ViewBillingRequest viewBillingRequest = ViewBillingRequest.builder()
.start(myStartTime)
.end(myEndTime)
.build();
ViewBillingIterable listRes = route53DomainsClient.viewBillingPaginator(viewBillingRequest);
listRes.stream()
.flatMap(r -> r.billingRecords().stream())
.forEach(content -> System.out.println(" Bill Date:: " + content.billDate() +
" Operation: " + content.operationAsString() +
" Price: " + content.price()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ViewBilling](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ViewBilling)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples)中設定和執行。
```
suspend fun listBillingRecords() {
val currentDate = Date()
val localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
val localDateTime2 = localDateTime.minusYears(1)
val myStartTime = localDateTime2.toInstant(zoneOffset)
val myEndTime = localDateTime.toInstant(zoneOffset)
val timeStart: Instant? = myStartTime?.let { Instant(it) }
val timeEnd: Instant? = myEndTime?.let { Instant(it) }
val viewBillingRequest =
ViewBillingRequest {
start = timeStart
end = timeEnd
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.viewBillingPaginated(viewBillingRequest)
.transform { it.billingRecords?.forEach { obj -> emit(obj) } }
.collect { billing ->
println("Bill Date: ${billing.billDate}")
println("Operation: ${billing.operation}")
println("Price: ${billing.price}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [ViewBilling](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用 Route 53](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。