DNS

DNS

Overview

Provides an Application Programming Interface (API) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of DNS service and how to call API. The API is provided as a RESTful API, and it responds in JSON format.

Version

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

VersionStatusNot Before
1.3CURRENT-

OpenAPI URL

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

Environment and Region List

environmentregion
skr-west1
skr-east1
gkr-south1
gkr-south2
gkr-south3
ekr-west1
ekr-east1

API Version History

1.3

  • DNS API has been updated to version 1.3.
  • DNS API versions 1.0 to 1.2 have been deprecated.

Changes

  • [Changed] POST /dns/1.1/hosted-zones - CreateHostedZone API has been changed.
    • The email field has been removed from the request.
  • [Changed] GET /dns/1.1/hosted-zones/{hosted_zone_id} - ShowHostedZone API has been changed.
    • The email field has been removed from the response.
  • [Changed] PUT /dns/1.1/hosted-zones/{hosted_zone_id} - SetHostedZone API has been changed.
    • The email field has been removed from the request.
  • [Changed] GET /dns/1.1/hosted-zones/{hosted_zone_id}/records - ListHostedZoneRecords API has been changed.
    • Zone apex record name is displayed as-is (without @. notation).
  • [Changed] GET /dns/1.1/public-domain-names - ListPublicDomainNames API has been changed.
    • Operation ID has been changed to listPublicDomainNames.
  • [Changed] POST /dns/1.1/public-domain-names - CreatePublicDomainName API has been changed.
    • Operation ID has been changed to createPublicDomainName.
  • [Changed] GET /dns/1.1/public-domain-names/{public_domain_id} - ShowPublicDomainName API has been changed.
    • Operation ID has been changed to showPublicDomainName.
  • [Changed] PUT /dns/1.1/public-domain-names/{public_domain_id} - SetPublicDomainName API has been changed.
    • Operation ID has been changed to setPublicDomainName.
  • [New] POST /dns/1.3/public-domain-names/{public_domain_id}/transfer - TransferPublicDomainName 1.3 API has been added.

1.2

DNS API has been updated to version 1.2.

Changes

  • [Changed] GET /dns/1.1/hosted-zones - ListHostedZones API has been changed.
    • The following field has been added to the response:
      • private_dns_name (Private DNS name lookup)
  • [Changed] GET /dns/1.1/hosted-zones/{hosted_zone_id} - ShowHostedZone API has been changed.
    • The following field has been added to the response:
      • private_dns_name (Private DNS name lookup)

1.1

DNS API has been updated to version 1.1.

Changes

  • [Changed] PATCH /dns/1.0/hosted-zones/{zone_id} - SetHostedZone 1.0 API has been changed.
    • Replaced by PUT /dns/1.0/hosted-zones/{hosted_zone_id} API.
  • [Deleted] POST /dns/1.0/public-domain-names/{public_domain_id}/renew - RenewPublicDomainName 1.0 API has been deleted.
    • This API is no longer available.
  • [Changed] GET /dns/1.1/hosted-zones/{hosted_zone_id}/records - ListHostedZoneRecords API has been changed.
    • Zone apex record name is displayed using @. notation.
  • [Changed] POST /dns/1.0/private-dns - CreatePrivateDns API has been changed.
    • The following fields have been added to the request:
      • registered_region
      • private_dns_cr_id

1.0

DNS API has been released.

Changes

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