There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `RegisterDomain` with an AWS SDK or CLI
`RegisterDomain`
The following code examples show how to use `RegisterDomain`.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code example:
+ [Learn the basics](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK for .NET**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](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;
}
}
```
+ For API details, see [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain) in *AWS SDK for .NET API Reference*.
------
#### [ CLI ]
**AWS CLI**
**To register a domain**
The following `register-domain` command registers a domain, retrieving all parameter values from a JSON-formatted file.
This command runs only in the `us-east-1` Region. If your default region is set to `us-east-1`, you can omit the `region` parameter.
```
aws route53domains register-domain \
--region us-east-1 \
--cli-input-json file://register-domain.json
```
Contents of `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
}
```
Output:
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
To confirm that the operation succeeded, you can run `get-operation-detail`. For more information, see [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html) .
For more information, see [Registering a New Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) in the *Amazon Route 53 Developer Guide*.
For information about which top-level domains (TLDs) require values for `ExtraParams` and what the valid values are, see [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html) in the *Amazon Route 53 API Reference*.
+ For API details, see [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](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 "";
}
```
+ For API details, see [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain) in *AWS SDK for Java 2.x API Reference*.
------
#### [ Kotlin ]
**SDK for Kotlin**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](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
}
}
```
+ For API details, see [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in *AWS SDK for Kotlin API reference*.
------