DNS

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 DNS 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

OpenAPI URL

https://dns.{region}.{environment}.samsungsdscloud.com

Environment and Region List

API Version History

1.3

• DNS API가 1.3 버전으로 업데이트 되었습니다.
• DNS API 1.0 ~ 1.2 버전은 DEPRECATED 되었습니다.

변경사항

• [변경] POST /dns/1.1/hosted-zones - CreateHostedZone API 가 변경되었습니다.
  • 요청 시, email 필드가 삭제되었습니다.
• [변경] GET /dns/1.1/hosted-zones/{hosted_zone_id} - ShowHostedZone API 가 변경되었습니다.
  • 응답 시, email 필드가 삭제되었습니다.
• [변경] PUT /dns/1.1/hosted-zones/{hosted_zone_id} - SetHostedZone API 가 변경되었습니다.
  • 요청 시, email 필드가 삭제되었습니다.
• [변경] GET /dns/1.1/hosted-zones/{hosted_zone_id}/records - ListHostedZoneRecords API 가 변경되었습니다.
  • Zone apex 레코드 이름이 원본 그대로 표시됩니다 (@. 표기법 미사용).
• [변경] GET /dns/1.1/public-domain-names - ListPublicDomainNames API 가 변경되었습니다.
  • Operation ID가 listPublicDomainNames로 변경되었습니다.
• [변경] POST /dns/1.1/public-domain-names - CreatePublicDomainName API 가 변경되었습니다.
  • Operation ID가 createPublicDomainName으로 변경되었습니다.
• [변경] GET /dns/1.1/public-domain-names/{public_domain_id} - ShowPublicDomainName API 가 변경되었습니다.
  • Operation ID가 showPublicDomainName으로 변경되었습니다.
• [변경] PUT /dns/1.1/public-domain-names/{public_domain_id} - SetPublicDomainName API 가 변경되었습니다.
  • Operation ID가 setPublicDomainName으로 변경되었습니다.
• [신규] POST /dns/1.3/public-domain-names/{public_domain_id}/transfer - TransferPublicDomainName 1.3 API 가 추가되었습니다.

1.2

DNS API가 1.2 버전으로 업데이트 되었습니다.

변경사항

• [변경] GET /dns/1.1/hosted-zones - ListHostedZones API 가 변경되었습니다.
  • 응답 시, 아래와 같은 필드가 추가됩니다.:
    • private_dns_name (Private DNS 이름 조회)
• [변경] GET /dns/1.1/hosted-zones/{hosted_zone_id} - ShowHostedZone API 가 변경되었습니다.
  • 응답 시, 아래와 같은 필드가 추가됩니다.:
    • private_dns_name (Private DNS 이름 조회)

1.1

DNS API가 1.1 버전으로 업데이트 되었습니다.

변경사항

• [변경] PATCH /dns/1.0/hosted-zones/{zone_id} - SetHostedZone 1.0 API 가 변경 되었습니다.
  • PUT /dns/1.0/hosted-zones/{hosted_zone_id} API 로 대체되었습니다.
• [삭제] POST /dns/1.0/public-domain-names/{public_domain_id}/renew - RenewPublicDomainName 1.0 API 가 삭제되었습니다.
  • 해당 API 는 더 이상 제공되지 않습니다.
• [변경] GET /dns/1.1/hosted-zones/{hosted_zone_id}/records - ListHostedZoneRecords API 가 변경되었습니다.
  • Zone apex 레코드 이름이 @. 표기법으로 표시됩니다.
• [변경] POST /dns/1.0/private-dns - CreatePrivateDns API 가 변경되었습니다.
  • 요청 시, 아래와 같은 필드가 추가됩니다.:
    • registered_region
    • private_dns_cr_id

1.0

DNS API가 출시되었습니다.

변경사항

• [신규] GET /dns/1.0/hosted-zones - ListHostedZones 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/hosted-zones - CreateHostedZone 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/hosted-zones/{zone_id} - ShowHostedZone 1.0 API 가 추가되었습니다.
• [신규] PATCH /dns/1.0/hosted-zones/{zone_id} - SetHostedZone 1.0 API 가 추가되었습니다.
• [신규] DELETE /dns/1.0/hosted-zones/{zone_id} - DeleteHostedZone 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/hosted-zones/{zone_id}/records - ListHostedZoneRecords 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/hosted-zones/{zone_id}/records - CreateHostedZoneRecord 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/hosted-zones/{zone_id}/records/{recordset_id} - ShowHostedZoneRecord 1.0 API 가 추가되었습니다.
• [신규] PUT /dns/1.0/hosted-zones/{zone_id}/records/{recordset_id} - SetHostedZoneRecord 1.0 API 가 추가되었습니다.
• [신규] DELETE /dns/1.0/hosted-zones/{zone_id}/records/{recordset_id} - DeleteHostedZoneRecord 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/private-dns - ListPrivateDns 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/private-dns - CreatePrivateDns 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/private-dns/{private_dns_id} - ShowPrivateDns 1.0 API 가 추가되었습니다.
• [신규] PUT /dns/1.0/private-dns/{private_dns_id} - SetPrivateDns 1.0 API 가 추가되었습니다.
• [신규] DELETE /dns/1.0/private-dns/{private_dns_id} - DeletePrivateDns 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/private-dns/activate - ActivatePrivateDns 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/public-domain-names - ListPublicDomainNames 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/public-domain-names - CreatePublicDomainName 1.0 API 가 추가되었습니다.
• [신규] GET /dns/1.0/public-domain-names/{public_domain_id} - ShowPublicDomainName 1.0 API 가 추가되었습니다.
• [신규] PUT /dns/1.0/public-domain-names/{public_domain_id} - SetPublicDomainName 1.0 API 가 추가되었습니다.
• [신규] PUT /dns/1.0/public-domain-names/{public_domain_id}/information - SetPublicDomainNameWhoisInfo 1.0 API 가 추가되었습니다.
• [신규] POST /dns/1.0/public-domain-names/{public_domain_id}/renew - RenewPublicDomainName 1.0 API 가 추가되었습니다.