文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `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` 命令返回有关域名 `example.com` 是否可以使用 Route 53 进行注册的信息。
此命令仅在 `us-east-1` 区域中运行。如果您的默认区域设置为 `us-east-1`，则可以省略 `region` 参数。
```
aws route53domains check-domain-availability \
--region us-east-1 \
--domain-name example.com
```
输出：
```
{
"Availability": "UNAVAILABLE"
}
```
Route 53 支持大量顶级域 (TLDs)，例如`.com`和`.jp`，但我们不支持所有可用的域名 TLDs。如果您查看某个域是否可用，而 Route 53 不支持该顶级域，`check-domain-availability` 会返回以下消息。
```
An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: tld is not supported.
```
有关在 Route 53 中注册域名时可以 TLDs 使用的列表，请参阅《亚马逊 Route 53 *开发者指南》中的可在亚马逊 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 ]
**适用于 Java 的 SDK 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 的详细信息，请参阅适用[CheckDomainAvailability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)于 K *otlin 的AWS SDK API 参考*。
------