Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Úselo `RegisterDomain` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `RegisterDomain`.
Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en el siguiente ejemplo de código:
+ [Conceptos básicos](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK para .NET**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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;
}
}
```
+ Para obtener más información sobre la API, consulta [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Para registrar un dominio**
El siguiente comando `register-domain` registra un dominio y recupera todos los valores de los parámetros de un archivo con formato JSON.
Este comando solo se ejecuta en la región `us-east-1`. Si su región predeterminada está configurada en `us-east-1`, puede omitir el parámetro `region`.
```
aws route53domains register-domain \
--region us-east-1 \
--cli-input-json file://register-domain.json
```
Contenido de `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
}
```
Salida:
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Para confirmar que la operación se ha realizado correctamente, puede ejecutar `get-operation-detail`. Para obtener más información, consulte [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html) .
Para obtener más información, consulte [Registering a New Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) en la *Guía para desarrolladores de Amazon Route 53*.
Para obtener información sobre los dominios de nivel superior (TLDs) que requieren valores `ExtraParams` y cuáles son los valores válidos, consulte la *referencia de [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html)la API de Amazon Route 53*.
+ Para obtener más información sobre la API, consulte [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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 "";
}
```
+ Para obtener más información sobre la API, consulta [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Kotlin ]
**SDK para Kotlin**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
}
}
```
+ Para obtener más información sobre la API, consulta [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la *referencia sobre el AWS SDK para la API de Kotlin*.
------
Para ver una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulta[Uso de Route 53 con un AWS SDK](sdk-general-information-section.md). En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.