# AWS CLI를 사용한 Route 53 도메인 등록 예시
다음 코드 예시는 Route 53 도메인 등록과 함께 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `check-domain-availability`
다음 코드 예시에서는 `check-domain-availability` 코드를 사용하는 방법을 보여줍니다.
**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은 `.com` 및 `.jp`와 같은 최상위 도메인(TLD)을 광범위하게 지원하지만, 사용 가능한 모든 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) 섹션을 참조하세요.
### `check-domain-transferability`
다음 코드 예시에서는 `check-domain-transferability` 코드를 사용하는 방법을 보여줍니다.
**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) 섹션을 참조하세요.
### `delete-tags-for-domain`
다음 코드 예시에서는 `delete-tags-for-domain` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인의 태그를 삭제하는 방법**
다음 `delete-tags-for-domain` 명령은 지정된 도메인에서 세 개의 태그를 삭제합니다. 단, 태그 값이 아닌 태그 키만 지정합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains delete-tags-for-domain \
--region us-east-1 \
--domain-name example.com \
--tags-to-delete accounting-key hr-key engineering-key
```
이 명령은 출력을 생성하지 않습니다.
태그가 삭제되었는지 확인하기 위해 [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html) 을 실행할 수 있습니다. 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html)를 참조하세요
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/delete-tags-for-domain.html) 섹션을 참조하세요.
### `disable-domain-auto-renew`
다음 코드 예시에서는 `disable-domain-auto-renew` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인 자동 갱신 비활성화**
다음 `disable-domain-auto-renew` 명령은 도메인 등록이 만료되기 전에 도메인 `example.com`을 자동으로 갱신하지 *않도록* Route 53을 구성합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains disable-domain-auto-renew \
--region us-east-1 \
--domain-name example.com
```
이 명령은 출력을 생성하지 않습니다.
설정이 변경되었는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다. 자동 갱신이 비활성화된 경우, `AutoRenew`의 값은 `False`입니다. 자동 갱신에 대한 자세한 내용은 *Amazon Route 53 개발자 안내서*의 도메인 등록 갱신을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DisableDomainAutoRenew](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/disable-domain-auto-renew.html) 섹션을 참조하세요.
### `disable-domain-transfer-lock`
다음 코드 예시에서는 `disable-domain-transfer-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인에서 전송 잠금을 비활성화하는 방법**
다음 `disable-domain-transfer-lock` 명령은 도메인을 다른 등록 기관으로 이전할 수 있도록 도메인 `example.com`의 이전 잠금을 제거합니다. 이 명령은 `clientTransferProhibited` 상태를 변경합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains disable-domain-transfer-lock \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
전송 잠금이 변경되었는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다. 이전 잠금이 비활성화되면, `StatusList`의 값에 `clientTransferProhibited`가 포함되지 *않습니다*.
이전 프로세스에 대한 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [도메인을 Amazon Route 53에서 다른 등록 기관으로 이전](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DisableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/disable-domain-transfer-lock.html) 섹션을 참조하세요.
### `enable-domain-auto-renew`
다음 코드 예시에서는 `enable-domain-auto-renew` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인 자동 갱신 활성화**
다음 `enable-domain-auto-renew` 명령은 도메인 `example.com`의 등록이 만료되기 전에 도메인을 자동으로 갱신하도록 Route 53을 구성합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains enable-domain-auto-renew \
--region us-east-1 \
--domain-name example.com
```
이 명령은 출력을 생성하지 않습니다. 설정이 변경되었는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다. 자동 갱신이 활성화된 경우, `AutoRenew`의 값은 `True`입니다.
자동 갱신에 대한 자세한 내용은 *Amazon Route 53 개발자 안내서*의 도메인 등록 갱신
다음 코드 예시에서는 `enable-domain-transfer-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인에서 전송 잠금을 활성화하는 방법**
다음 `enable-domain-transfer-lock` 명령은 지정된 도메인을 잠가 다른 등록 기관으로 이전할 수 없도록 합니다. 이 명령은 `clientTransferProhibited` 상태를 변경합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains enable-domain-transfer-lock \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
전송 잠금이 변경되었는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다. 이전 잠금이 활성화되면 `StatusList`의 값에 `clientTransferProhibited`가 포함됩니다.
이전 프로세스에 대한 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [도메인을 Amazon Route 53에서 다른 등록 기관으로 이전](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [EnableDomainTransferLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/enable-domain-transfer-lock.html) 섹션을 참조하세요.
### `get-contact-reachability-status`
다음 코드 예시에서는 `get-contact-reachability-status` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**등록자 연락 담당자가 확인 이메일에 응답했는지 확인하는 방법**
다음 `get-contact-reachability-status` 명령은 지정된 도메인의 등록자 연락처가 확인 이메일에 응답했는지 여부에 대한 정보를 반환합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains get-contact-reachability-status \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"domainName": "example.com",
"status": "DONE"
}
```
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Resending Authorization and Confirmation Emails](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetContactReachabilityStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-contact-reachability-status.html) 섹션을 참조하세요.
### `get-domain-detail`
다음 코드 예시에서는 `get-domain-detail` 코드를 사용하는 방법을 보여줍니다.
**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) 섹션을 참조하세요.
### `get-domain-suggestions`
다음 코드 예시에서는 `get-domain-suggestions` 코드를 사용하는 방법을 보여줍니다.
**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) 섹션을 참조하세요.
### `get-operation-detail`
다음 코드 예시에서는 `get-operation-detail` 코드를 사용하는 방법을 보여줍니다.
**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) 섹션을 참조하세요.
### `list-domains`
다음 코드 예시에서는 `list-domains` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**현재 AWS 계정에 등록된 도메인을 나열하는 방법**
다음 AWS 명령은 현재 `list-domains` 계정에 등록된 도메인에 대한 요약된 정보를 나열합니다.
이 명령은 `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) 섹션을 참조하세요.
### `list-operations`
다음 코드 예시에서는 `list-operations` 코드를 사용하는 방법을 보여줍니다.
**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일 오전 12:00 UTC 이후에 제출된 모든 작업의 상태를 가져옵니다.
```
aws route53domains list-operations \
--submitted-since 1577836800
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-operations.html) 섹션을 참조하세요.
### `list-tags-for-domain`
다음 코드 예시에서는 `list-tags-for-domain` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인의 태그를 나열하는 방법**
다음 `list-tags-for-domain` 명령은 지정된 도메인에 현재 연결된 태그를 나열합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains list-tags-for-domain \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"TagList": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
]
}
```
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html)를 참조하세요
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-tags-for-domain.html) 섹션을 참조하세요.
### `register-domain`
다음 코드 예시에서는 `register-domain` 코드를 사용하는 방법을 보여줍니다.
**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)을 참조하세요.
`ExtraParams`의 값이 필요한 최상위 도메인(TLD)과 유효한 값에 대한 자세한 내용은 *Amazon Route 53 API 참조*의 [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI API 참조*의 [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html) 섹션을 참조하세요.
### `renew-domain`
다음 코드 예시에서는 `renew-domain` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인을 갱신하는 방법**
다음 `renew-domain` 명령은 지정된 도메인을 5년 동안 갱신합니다. `current-expiry-year`의 값을 가져오려면 `get-domain-detail` 명령을 사용하고 Unix 형식에서 `ExpirationDate` 값을 변환합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains renew-domain \
--region us-east-1 \
--domain-name example.com \
--duration-in-years 5 \
--current-expiry-year 2020
```
출력:
```
{
"OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}
```
작업이 성공했는지 확인하기 위해 `get-operation-detail`을 실행할 수 있습니다. 자세한 내용은 [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html)을 참조하세요.
.com 또는 .org와 같은 각 최상위 도메인(TLD)의 레지스트리는 도메인을 갱신할 수 있는 최대 연도를 제어합니다. 도메인의 최대 갱신 기간을 확인하려면 *Amazon Route 53 개발자 안내서*의 [Amazon Route 53에 등록할 수 있는 도메인](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html)에서 TLD에 대한 '등록 및 갱신 기간' 섹션을 참조하세요.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Renewing Registration for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [RenewDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/renew-domain.html) 섹션을 참조하세요.
### `resend-contact-reachability-email`
다음 코드 예시에서는 `resend-contact-reachability-email` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**등록자 연락처의 현재 이메일 주소로 확인 이메일 재전송**
다음 `resend-contact-reachability-email` 명령은 example.com 도메인의 등록자 연락처에 대한 현재 이메일 주소로 확인 이메일을 재전송합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains resend-contact-reachability-email \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"domainName": "example.com",
"emailAddress": "moliveira@example.com",
"isAlreadyVerified": true
}
```
이 예시에서와 같이 `true`의 값이 `isAlreadyVerified`인 경우, 등록자 연락처가 지정된 이메일 주소에 연결할 수 있음을 이미 확인한 것입니다.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Resending Authorization and Confirmation Emails](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-click-email-link.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ResendContactReachabilityEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/resend-contact-reachability-email.html) 섹션을 참조하세요.
### `retrieve-domain-auth-code`
다음 코드 예시에서는 `retrieve-domain-auth-code` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인을 다른 등록 기관으로 전송할 수 있도록 도메인에 대한 권한 부여 코드를 가져오는 방법**
다음 `retrieve-domain-auth-code` 명령은 example.com 도메인의 현재 인증 코드를 가져옵니다. 도메인을 다른 등록 기관으로 이전하려는 경우 해당 도메인 등록 기관에 이 값을 제공합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains retrieve-domain-auth-code \
--region us-east-1 \
--domain-name example.com
```
출력:
```
{
"AuthCode": ")o!v3dJeXampLe"
}
```
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Transferring a Domain from Amazon Route 53 to Another Registrar](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-from-route-53.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [RetrieveDomainAuthCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/retrieve-domain-auth-code.html) 섹션을 참조하세요.
### `transfer-domain`
다음 코드 예시에서는 `transfer-domain` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인을 Amazon Route 53으로 이전**
다음 `transfer-domain` 명령은 JSON 형식 파일 `C:\temp\transfer-domain.json`에서 제공하는 파라미터와 함께 도메인을 Route 53으로 이전합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains transfer-domain \
--region us-east-1 \
--cli-input-json file://C:\temp\transfer-domain.json
```
`transfer-domain.json`의 콘텐츠:
```
{
"DomainName": "example.com",
"DurationInYears": 1,
"Nameservers": [
{
"Name": "ns-2048.awsdns-64.com"
},
{
"Name": "ns-2049.awsdns-65.net"
},
{
"Name": "ns-2050.awsdns-66.org"
},
{
"Name": "ns-2051.awsdns-67.co.uk"
}
],
"AuthCode": ")o!v3dJeXampLe",
"AutoRenew": true,
"AdminContact": {
"FirstName": "Martha",
"LastName": "Rivera",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mrivera@example.com"
},
"RegistrantContact": {
"FirstName": "Li",
"LastName": "Juan",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ljuan@example.com"
},
"TechContact": {
"FirstName": "Mateo",
"LastName": "Jackson",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mjackson@example.com"
},
"PrivacyProtectAdminContact": true,
"PrivacyProtectRegistrantContact": true,
"PrivacyProtectTechContact": true
}
```
출력:
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
작업이 성공했는지 확인하기 위해 `get-operation-detail`을 실행할 수 있습니다. 자세한 내용은 [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html)을 참조하세요.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [도메인 등록을 Amazon Route 53으로 이전](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [TransferDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/transfer-domain.html) 섹션을 참조하세요.
### `update-domain-contact-privacy`
다음 코드 예시에서는 `update-domain-contact-privacy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인의 연락처에 대한 개인 정보 보호 설정을 업데이트하는 방법**
다음 `update-domain-contact-privacy` 명령은 example.com 도메인의 관리 연락처에 대한 개인 정보 보호를 해제합니다. 이 명령은 `us-east-1` 리전에서만 실행됩니다.
기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains update-domain-contact-privacy \
--region us-east-1 \
--domain-name example.com \
--no-admin-privacy
```
출력:
```
{
"OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
작업이 성공했는지 확인하기 위해 `get-operation-detail`을 실행할 수 있습니다. 자세한 내용은 [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html)을 참조하세요.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Enabling or Disabling Privacy Protection for Contact Information for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-privacy-protection.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateDomainContactPrivacy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact-privacy.html) 섹션을 참조하세요.
### `update-domain-contact`
다음 코드 예시에서는 `update-domain-contact` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인 연락처 정보 업데이트**
다음 `update-domain-contact` 명령은 도메인의 연락처 정보를 업데이트하여 JSON 형식 파일 `C:\temp\update-domain-contact.json`에서 파라미터를 가져옵니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains update-domain-contact \
--region us-east-1 \
--cli-input-json file://C:\temp\update-domain-contact.json
```
`update-domain-contact.json`의 콘텐츠:
```
{
"AdminContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
},
"DomainName": "example.com",
"RegistrantContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
},
"TechContact": {
"AddressLine1": "101 Main Street",
"AddressLine2": "Suite 1a",
"City": "Seattle",
"ContactType": "COMPANY",
"CountryCode": "US",
"Email": "w.xiulan@example.com",
"FirstName": "Wang",
"LastName": "Xiulan",
"OrganizationName": "Example",
"PhoneNumber": "+1.8005551212",
"State": "WA",
"ZipCode": "98101"
}
}
```
출력:
```
{
"OperationId": "b3a219e9-d801-4244-b533-b7256example"
}
```
작업이 성공했는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다. 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Updating Contact Information for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-update-contacts.html#domain-update-contacts-basic)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateDomainContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-contact.html) 섹션을 참조하세요.
### `update-domain-nameservers`
다음 코드 예시에서는 `update-domain-nameservers` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인의 이름 서버 업데이트**
다음 `update-domain-nameservers` 명령은 도메인의 이름 서버를 업데이트합니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains update-domain-nameservers \
--region us-east-1 \
--domain-name example.com \
--nameservers Name=ns-1.awsdns-01.org Name=ns-2.awsdns-02.co.uk Name=ns-3.awsdns-03.net Name=ns-4.awsdns-04.com
```
출력:
```
{
"OperationId": "f1691ec4-0e7a-489e-82e0-b19d3example"
}
```
작업이 성공했는지 확인하기 위해 [get-domain-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-domain-detail.html)을 실행할 수 있습니다.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Adding or Changing Name Servers and Glue Records for a Domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-name-servers-glue-records.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateDomainNameservers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-domain-nameservers.html) 섹션을 참조하세요.
### `update-tags-for-domain`
다음 코드 예시에서는 `update-tags-for-domain` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**도메인에 대한 태그를 추가하거나 업데이트하는 방법**
다음 `update-tags-for-domain` 명령은 example.com 도메인에 대한 두 개의 키와 그에 해당하는 값을 추가하거나 업데이트합니다. 키 값을 업데이트하는 방법 키와 새 값을 포함하면 됩니다. 한 번에 하나의 도메인에서만 태그를 추가하거나 업데이트할 수 있습니다.
이 명령은 `us-east-1` 리전에서만 실행됩니다. 기본 리전이 `us-east-1`로 설정된 경우, `region` 파라미터를 생략할 수 있습니다.
```
aws route53domains update-tags-for-domain \
--region us-east-1 \
--domain-name example.com \
--tags-to-update "Key=key1,Value=value1" "Key=key2,Value=value2"
```
이 명령은 출력을 생성하지 않습니다. 태그가 추가 또는 업데이트되었는지 확인하기 위해 [list-tags-for-domain](https://docs.aws.amazon.com/cli/latest/reference/route53domains/list-tags-for-domain.html) 을 실행할 수 있습니다.
자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Tagging Amazon Route 53 Resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/tagging-resources.html)를 참조하세요
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateTagsForDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/update-tags-for-domain.html) 섹션을 참조하세요.
### `view-billing`
다음 코드 예시에서는 `view-billing` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**현재 AWS 계정의 도메인 등록 요금에 대한 결제 정보를 가져오는 방법**
다음 `view-billing` 명령은 2018년 1월 1일(1514764800 Unix 시간)부터 2019년 12월 31일 자정(1577836800 Unix 시간)까지의 기간 동안 현재 계정의 모든 도메인 관련 결제 레코드를 반환합니다.
이 명령은 `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) 섹션을 참조하세요.