이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

DNS

1: APIs

1.1: Activate Private DNS

1.1.1: 1.3

1.2: Create Hosted Zone

1.2.1: 1.3

1.3: Create Hosted Zone Record

1.3.1: 1.3

1.4: Create Private DNS

1.4.1: 1.3

1.5: Create Public Domain Name

1.5.1: 1.3

1.6: Delete Hosted Zone

1.6.1: 1.3

1.7: Delete Hosted Zone Record

1.7.1: 1.3

1.8: Delete Private DNS

1.8.1: 1.3

1.9: List Hosted Zone Records

1.9.1: 1.3

1.10: List Hosted Zones

1.10.1: 1.3

1.11: List Private DNS

1.11.1: 1.3

1.12: List Public Domain Names

1.12.1: 1.3

1.13: Set Hosted Zone

1.13.1: 1.3

1.14: Set Hosted Zone Record

1.14.1: 1.3

1.15: Set Private DNS

1.15.1: 1.3

1.16: Set Public Domain Name

1.16.1: 1.3

1.17: Set Public Domain Name Whois Info

1.17.1: 1.3

1.18: Show Hosted Zone

1.18.1: 1.3

1.19: Show Hosted Zone Record

1.19.1: 1.3

1.20: Show Private DNS

1.20.1: 1.3

1.21: Show Public Domain Name

1.21.1: 1.3

1.22: Transfer Public Domain Name

1.22.1: 1.3

2: Models

2.1: CreatePublicDomainRequest
2.2: CreatePublicDomainResponse
2.3: HostedZoneCreateRequestV1Dot3
2.4: HostedZoneListResponseV1Dot3
2.5: HostedZoneSetRequestV1Dot3
2.6: HostedZoneShowResponseV1Dot3
2.7: HostedZoneV1Dot3
2.8: PrivateDns
2.9: PrivateDnsActivateRequest
2.10: PrivateDnsCreateRequest
2.11: PrivateDnsListResponse
2.12: PrivateDnsSetRequest
2.13: PrivateDnsShowResponse
2.14: PubblicDomainWhoisInfoUpdateRequest
2.15: PublicDomainDetail
2.16: PublicDomainDetailResponse
2.17: PublicDomainListItem
2.18: PublicDomainListResponse
2.19: PublicDomainPartialUpdateRequest
2.20: PublicDomainPartialUpdateResponse
2.21: PublicDomainTransferRequest
2.22: PublicDomainTransferResponse
2.23: PublicDomainWhoisInfoUpdateResponse
2.24: Record
2.25: RecordCreateRequest
2.26: RecordCreateResponse
2.27: RecordListResponse
2.28: RecordSetRequest
2.29: RecordSetResponse
2.30: RecordShowResponse
2.31: Tag

Overview

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

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

Version

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

Version	Status	Not Before
1.3	CURRENT	-

OpenAPI URL

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

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

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 가 추가되었습니다.

1 - APIs

1.1 - Activate Private DNS

1.1.1 - 1.3

post /v1/private-dns/activate

Description

Private DNS 활성화

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		PrivateDnsActivateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	PrivateDnsShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/private-dns/activate

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "name": "private-dns01"
}

Example HTTP response

Response 202

{
    "private_dns": {
        "auth_dns_name": "authdns-a1b2c3d4e5f6789012345678abcdef90",
        "connected_vpc_ids": [
            "1234567890abcdef1234567890abcdef",
            "fedcba0987654321fedcba0987654321"
        ],
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "This is description",
        "id": "fedcba9876543210fedcba9876543210",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "private-dns01",
        "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
        "pool_name": "private01-a1b2c3d4e5f6789012345678abcdef90",
        "registered_region": "KR-WEST1",
        "resolver_ip": "198.19.0.101",
        "resolver_name": "resolver-a1b2c3d4e5f6789012345678abcdef90",
        "state": "ACTIVE"
    }
}

1.2 - Create Hosted Zone

1.2.1 - 1.3

post /v1/hosted-zones

Description

도메인 이름 해석을 관리하는 DNS 레코드를 포함하는 Hosted Zone을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		HostedZoneCreateRequestV1Dot3

Responses

HTTP Code	Description	Schema
202	Accepted	HostedZoneShowResponseV1Dot3
400	Bad Request	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "description": "This is description",
    "name": "my-zone.com",
    "private_dns_id": "fedcba9876543210fedcba9876543210",
    "tags": [],
    "type": "private"
}

Example HTTP response

Response 202

{
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "This is description",
    "hosted_zone_type": "public",
    "id": "3432012nfdksdf03ktrld9234lgfg",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "my-zone.com",
    "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
    "private_dns_id": "fedcba9876543210fedcba9876543210",
    "private_dns_name": "private-dns01",
    "status": "CREATING",
    "ttl": 3600
}

1.3 - Create Hosted Zone Record

1.3.1 - 1.3

post /v1/hosted-zones/{hosted_zone_id}/records

Description

도메인 이름 해석을 관리하는 DNS 레코드 리소스를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
body	body required		RecordCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	RecordCreateResponse
400	Bad Request	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}/records

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "description": "This is description",
    "name": "test.app",
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "ttl": 3600,
    "type": "A"
}

Example HTTP response

Response 202

{
    "action": "CREATE",
    "created_at": "2025-09-08T03:43:57Z",
    "description": "This is description",
    "id": "6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7",
    "links": "",
    "name": "test.app",
    "project_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "status": "ACTIVE",
    "ttl": 3600,
    "type": "A",
    "updated_at": "2026-02-09T08:00:40Z",
    "version": 1,
    "zone_id": "3432012nfdksdf03ktrld9234lgfg",
    "zone_name": "my-zone.com"
}

1.4 - Create Private DNS

1.4.1 - 1.3

post /v1/private-dns

Description

내부 DNS 해석을 관리하는 프라이빗 DNS 인스턴스를 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		PrivateDnsCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	PrivateDnsShowResponse
400	Bad Request	None
403	Forbidden	None

Example HTTP request

Request path

/v1/private-dns

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "connected_vpc_ids": [
        "1234567890abcdef1234567890abcdef",
        "fedcba0987654321fedcba0987654321"
    ],
    "description": "This is description",
    "name": "private-dns01",
    "tags": [
        {
            "key": "env",
            "value": "prod"
        }
    ]
}

Example HTTP response

Response 202

{
    "private_dns": {
        "auth_dns_name": "authdns-a1b2c3d4e5f6789012345678abcdef90",
        "connected_vpc_ids": [
            "1234567890abcdef1234567890abcdef",
            "fedcba0987654321fedcba0987654321"
        ],
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "This is description",
        "id": "fedcba9876543210fedcba9876543210",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "private-dns01",
        "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
        "pool_name": "private01-a1b2c3d4e5f6789012345678abcdef90",
        "registered_region": "KR-WEST1",
        "resolver_ip": "198.19.0.101",
        "resolver_name": "resolver-a1b2c3d4e5f6789012345678abcdef90",
        "state": "ACTIVE"
    }
}

1.5 - Create Public Domain Name

1.5.1 - 1.3

post /v1/public-domain-names

Description

Public Domain Name 생성

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		CreatePublicDomainRequest

Responses

HTTP Code	Description	Schema
201	Created	CreatePublicDomainResponse
400	Bad Request	None
403	Forbidden	None

Example HTTP request

Request path

/v1/public-domain-names

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "address_type": "",
    "auto_extension": true,
    "description": "This is description",
    "domestic_first_address_en": "125 Olympic-ro 35-gil, Songpa-gu, Seoul",
    "domestic_first_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동)",
    "domestic_second_address_en": "West Campus 1F",
    "domestic_second_address_ko": "서관 1층",
    "name": "example.com",
    "overseas_first_address": "123 Main St",
    "overseas_second_address": "New York",
    "overseas_third_address": "NY 10001",
    "postal_code": "12345",
    "register_email": "admin@example.com",
    "register_name_en": "Hong Gildong",
    "register_name_ko": "홍길동",
    "register_telno": "",
    "tags": [
        {
            "key": "env",
            "value": "prod"
        }
    ]
}

Example HTTP response

Response 201

{
    "public_domain_name": {
        "address_type": "DOMESTIC",
        "auto_extension": true,
        "created_at": "2025-09-08T03:43:57Z",
        "created_by": "504f24f8111e42e0578f367acd2a149f",
        "description": "This is description",
        "domestic_address_en": "West Campus 1F, 125 Olympic-ro 35-gil, Songpa-gu, Seoul",
        "domestic_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동), 서관 1층",
        "domestic_first_address_en": "125 Olympic-ro 35-gil, Songpa-gu, Seoul",
        "domestic_first_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동)",
        "domestic_second_address_en": "West Campus 1F",
        "domestic_second_address_ko": "서관 1층",
        "expired_date": "2026-09-09T00:00:00Z",
        "id": "10fjkeweffpublicdomain3193rud543",
        "modified_at": "2026-02-09T08:00:40Z",
        "modified_by": "504f24f8111e42e0578f367acd2a149f",
        "name": "example.com",
        "overseas_address": "123 Main St, New York, NY 10001",
        "overseas_first_address": "123 Main St",
        "overseas_second_address": "New York",
        "overseas_third_address": "NY 10001",
        "postal_code": "12345",
        "register_email": "admin@example.com",
        "register_name_en": "Hong Gildong",
        "register_name_ko": "홍길동",
        "register_telno": "",
        "start_date": "2025-09-09T00:00:00Z",
        "status": "REGISTERED"
    }
}

1.6 - Delete Hosted Zone

1.6.1 - 1.3

delete /v1/hosted-zones/{hosted_zone_id}

Description

Hosted Zone 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 202

1.7 - Delete Hosted Zone Record

1.7.1 - 1.3

delete /v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Description

Hosted zone record 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	이 Record를 포함하는 Hosted Zone의 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
path	record_id required	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	RecordCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 202

{
    "action": "CREATE",
    "created_at": "2025-09-08T03:43:57Z",
    "description": "This is description",
    "id": "6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7",
    "links": "",
    "name": "test.app",
    "project_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "status": "ACTIVE",
    "ttl": 3600,
    "type": "A",
    "updated_at": "2026-02-09T08:00:40Z",
    "version": 1,
    "zone_id": "3432012nfdksdf03ktrld9234lgfg",
    "zone_name": "my-zone.com"
}

1.8 - Delete Private DNS

1.8.1 - 1.3

delete /v1/private-dns/{private_dns_id}

Description

Private DNS 삭제

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	private_dns_id required	프라이빗 DNS의 고유 식별자 Example : `fedcba9876543210fedcba9876543210`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/private-dns/{private_dns_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 202

1.9 - List Hosted Zone Records

1.9.1 - 1.3

get /v1/hosted-zones/{hosted_zone_id}/records

Description

Record 목록을 제공합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
query	limit optional	반환할 최대 항목 수 Example :	any of [integer, null]	None
query	marker optional	이전 페이지의 마지막 레코드 ID Example :	any of [string, null]	None
query	sort_dir optional	목록의 정렬 방향(ASC 또는 DESC) Example :	any of [string, null]	None
query	sort_key optional	정렬 기준 필드 Example :	any of [string, null]	None
query	name optional	Record 이름 Example : `test.app`	any of [string, null]	None
query	exact_name optional	Record 이름 Example : `test.app`	any of [string, null]	None
query	type optional	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	any of [string, null]	None
query	data optional	DNS 레코드 필터링 데이터 Example : `12345.ns.private.kr-west1.dev2.samsungsdscloud.com`	any of [string, null]	None
query	status optional	DNS 레코드의 현재 상태 Example : `ACTIVE`	any of [string, null]	None
query	description optional	설명 Example : `This is description`	any of [string, null]	None
query	ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]	None

Responses

HTTP Code	Description	Schema
200	OK	RecordListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}/records

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "count": 20,
    "links": "",
    "metadata": "",
    "records": [
        {
            "action": "CREATE",
            "created_at": "2025-09-08T03:43:57Z",
            "description": "This is description",
            "id": "6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7",
            "links": "",
            "name": "test.app",
            "project_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
            "records": [
                "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
            ],
            "status": "ACTIVE",
            "ttl": 3600,
            "type": "A",
            "updated_at": "2026-02-09T08:00:40Z",
            "version": 1,
            "zone_id": "3432012nfdksdf03ktrld9234lgfg",
            "zone_name": "my-zone.com"
        }
    ]
}

1.10 - List Hosted Zones

1.10.1 - 1.3

get /v1/hosted-zones

Description

Hosted zone 목록

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. Example : `my-zone.com`	any of [string, null]	None
query	type optional	Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) Example :	any of [enum (public, private), null]	None
query	status optional	Hosted Zone의 현재 상태(예: ACTIVE, CREATING, DELETING) Example :	any of [enum (CREATING, EDITING, ACTIVE, DELETING, DELETED, ERROR, PENDING, UNKNOWN), null]	None

Responses

HTTP Code	Description	Schema
200	OK	HostedZoneListResponseV1Dot3
403	Forbidden	None

Example HTTP request

Request path

/v1/hosted-zones

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "count": 20,
    "hosted_zones": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "This is description",
            "hosted_zone_type": "public",
            "id": "3432012nfdksdf03ktrld9234lgfg",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "my-zone.com",
            "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
            "private_dns_id": "fedcba9876543210fedcba9876543210",
            "private_dns_name": "private-dns01",
            "status": "CREATING",
            "ttl": 3600
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.11 - List Private DNS

1.11.1 - 1.3

get /v1/private-dns

Description

프라이빗 DNS 목록

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	id optional	프라이빗 DNS의 고유 식별자 Example : `fedcba9876543210fedcba9876543210`	any of [string, null]	None
query	name optional	Private DNS 이름 Example : `private-dns01`	any of [string, null]	None
query	vpc_id optional	이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. Example : `7df8abb4912e4709b1cb237daccca7a8`	any of [string, null]	None
query	state optional	상태 Example : `ACTIVE`	any of [enum (CREATING, EDITING, ACTIVE, ACTIVATING, INACTIVE, DELETING, DELETED, ERROR, PENDING), null]	None

Responses

HTTP Code	Description	Schema
200	OK	PrivateDnsListResponse
400	Bad Request	None
403	Forbidden	None

Example HTTP request

Request path

/v1/private-dns

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "private_dns": [
        {
            "auth_dns_name": "authdns-a1b2c3d4e5f6789012345678abcdef90",
            "connected_vpc_ids": [
                "1234567890abcdef1234567890abcdef",
                "fedcba0987654321fedcba0987654321"
            ],
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "This is description",
            "id": "fedcba9876543210fedcba9876543210",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "private-dns01",
            "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
            "pool_name": "private01-a1b2c3d4e5f6789012345678abcdef90",
            "registered_region": "KR-WEST1",
            "resolver_ip": "198.19.0.101",
            "resolver_name": "resolver-a1b2c3d4e5f6789012345678abcdef90",
            "state": "ACTIVE"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.12 - List Public Domain Names

1.12.1 - 1.3

get /v1/public-domain-names

Description

Public Domain Name 목록

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	Public Domain Name 이름 Example : `example.com`	any of [string, null]	None
query	created_by optional	리소스를 생성한 사용자 ID Example : `504f24f8111e42e0578f367acd2a149f`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PublicDomainListResponse
400	Bad Request	None
403	Forbidden	None

Example HTTP request

Request path

/v1/public-domain-names

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "public_domain_names": [
        {
            "created_at": "2025-09-08T03:43:57Z",
            "created_by": "504f24f8111e42e0578f367acd2a149f",
            "expired_date": "2026-09-09T00:00:00Z",
            "id": "10fjkeweffpublicdomain3193rud543",
            "modified_at": "2026-02-09T08:00:40Z",
            "modified_by": "504f24f8111e42e0578f367acd2a149f",
            "name": "example.com",
            "register_email": "admin@example.com",
            "start_date": "2025-09-09T00:00:00Z",
            "status": "REGISTERED"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.13 - Set Hosted Zone

1.13.1 - 1.3

put /v1/hosted-zones/{hosted_zone_id}

Description

Hosted zone 업데이트

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
body	body required		HostedZoneSetRequestV1Dot3

Responses

HTTP Code	Description	Schema
202	Accepted	HostedZoneShowResponseV1Dot3
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "description": "This is description"
}

Example HTTP response

Response 202

{
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "This is description",
    "hosted_zone_type": "public",
    "id": "3432012nfdksdf03ktrld9234lgfg",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "my-zone.com",
    "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
    "private_dns_id": "fedcba9876543210fedcba9876543210",
    "private_dns_name": "private-dns01",
    "status": "CREATING",
    "ttl": 3600
}

1.14 - Set Hosted Zone Record

1.14.1 - 1.3

put /v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Description

Hosted zone record 값 업데이트

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	이 Record를 포함하는 Hosted Zone의 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
path	record_id required	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	string	None
body	body required		RecordSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	RecordSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "ttl": 3600
}

Example HTTP response

Response 202

{
    "action": "CREATE",
    "created_at": "2025-09-08T03:43:57Z",
    "description": "This is description",
    "id": "6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7",
    "links": "",
    "name": "test.app",
    "project_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "status": "ACTIVE",
    "ttl": 3600,
    "type": "A",
    "updated_at": "2026-02-09T08:00:40Z",
    "version": 1,
    "zone_id": "3432012nfdksdf03ktrld9234lgfg",
    "zone_name": "my-zone.com"
}

1.15 - Set Private DNS

1.15.1 - 1.3

put /v1/private-dns/{private_dns_id}

Description

Private DNS에 연결된 VPC 목록을 업데이트합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	private_dns_id required	프라이빗 DNS의 고유 식별자 Example : `fedcba9876543210fedcba9876543210`	string	None
body	body required		PrivateDnsSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	PrivateDnsShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/private-dns/{private_dns_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "connected_vpc_ids": [
        "1234567890abcdef1234567890abcdef",
        "fedcba0987654321fedcba0987654321"
    ],
    "description": "This is description"
}

Example HTTP response

Response 202

{
    "private_dns": {
        "auth_dns_name": "authdns-a1b2c3d4e5f6789012345678abcdef90",
        "connected_vpc_ids": [
            "1234567890abcdef1234567890abcdef",
            "fedcba0987654321fedcba0987654321"
        ],
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "This is description",
        "id": "fedcba9876543210fedcba9876543210",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "private-dns01",
        "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
        "pool_name": "private01-a1b2c3d4e5f6789012345678abcdef90",
        "registered_region": "KR-WEST1",
        "resolver_ip": "198.19.0.101",
        "resolver_name": "resolver-a1b2c3d4e5f6789012345678abcdef90",
        "state": "ACTIVE"
    }
}

1.16 - Set Public Domain Name

1.16.1 - 1.3

put /v1/public-domain-names/{public_domain_id}

Description

Public Domain Name 업데이트

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	public_domain_id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string	None
body	body required		PublicDomainPartialUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	PublicDomainPartialUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/public-domain-names/{public_domain_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "auto_extension": true,
    "description": "This is description"
}

Example HTTP response

Response 200

{
    "auto_extension": true,
    "description": "This is description",
    "id": "10fjkeweffpublicdomain3193rud543"
}

1.17 - Set Public Domain Name Whois Info

1.17.1 - 1.3

put /v1/public-domain-names/{public_domain_id}/information

Description

Public Domain Name Whois 정보 업데이트

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	public_domain_id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string	None
body	body required		PubblicDomainWhoisInfoUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	PublicDomainWhoisInfoUpdateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
500	Internal Server Error	None

Example HTTP request

Request path

/v1/public-domain-names/{public_domain_id}/information

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "address_type": "",
    "domestic_first_address_en": "125 Olympic-ro 35-gil, Songpa-gu, Seoul",
    "domestic_first_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동)",
    "domestic_second_address_en": "West Campus 1F",
    "domestic_second_address_ko": "서관 1층",
    "overseas_first_address": "123 Main St",
    "overseas_second_address": "New York",
    "overseas_third_address": "NY 10001",
    "postal_code": "12345",
    "register_email": "admin@example.com",
    "register_telno": ""
}

Example HTTP response

Response 200

{
    "address_type": "",
    "domestic_first_address_en": "125 Olympic-ro 35-gil, Songpa-gu, Seoul",
    "domestic_first_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동)",
    "domestic_second_address_en": "West Campus 1F",
    "domestic_second_address_ko": "서관 1층",
    "name": "example.com",
    "overseas_first_address": "123 Main St",
    "overseas_second_address": "New York",
    "overseas_third_address": "NY 10001",
    "postal_code": "12345",
    "register_email": "admin@example.com",
    "register_name_en": "Hong Gildong",
    "register_name_ko": "홍길동",
    "register_telno": ""
}

1.18 - Show Hosted Zone

1.18.1 - 1.3

get /v1/hosted-zones/{hosted_zone_id}

Description

Hosted zone 상세

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None

Responses

HTTP Code	Description	Schema
200	OK	HostedZoneShowResponseV1Dot3
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "This is description",
    "hosted_zone_type": "public",
    "id": "3432012nfdksdf03ktrld9234lgfg",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "my-zone.com",
    "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
    "private_dns_id": "fedcba9876543210fedcba9876543210",
    "private_dns_name": "private-dns01",
    "status": "CREATING",
    "ttl": 3600
}

1.19 - Show Hosted Zone Record

1.19.1 - 1.3

get /v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Description

Hosted zone record 상세

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	hosted_zone_id required	이 Record를 포함하는 Hosted Zone의 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string	None
path	record_id required	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	string	None

Responses

HTTP Code	Description	Schema
200	OK	RecordShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/hosted-zones/{hosted_zone_id}/records/{record_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "action": "CREATE",
    "created_at": "2025-09-08T03:43:57Z",
    "description": "This is description",
    "id": "6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7",
    "links": "",
    "name": "test.app",
    "project_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
    "records": [
        "12345.ns.private.kr-west1.dev2.samsungsdscloud.com"
    ],
    "status": "ACTIVE",
    "ttl": 3600,
    "type": "A",
    "updated_at": "2026-02-09T08:00:40Z",
    "version": 1,
    "zone_id": "3432012nfdksdf03ktrld9234lgfg",
    "zone_name": "my-zone.com"
}

1.20 - Show Private DNS

1.20.1 - 1.3

get /v1/private-dns/{private_dns_id}

Description

프라이빗 DNS 상세

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	private_dns_id required	프라이빗 DNS의 고유 식별자 Example : `fedcba9876543210fedcba9876543210`	string	None

Responses

HTTP Code	Description	Schema
200	OK	PrivateDnsShowResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/private-dns/{private_dns_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "private_dns": {
        "auth_dns_name": "authdns-a1b2c3d4e5f6789012345678abcdef90",
        "connected_vpc_ids": [
            "1234567890abcdef1234567890abcdef",
            "fedcba0987654321fedcba0987654321"
        ],
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "This is description",
        "id": "fedcba9876543210fedcba9876543210",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "private-dns01",
        "pool_id": "12345678-90ab-cdef-1234-567890abcdef",
        "pool_name": "private01-a1b2c3d4e5f6789012345678abcdef90",
        "registered_region": "KR-WEST1",
        "resolver_ip": "198.19.0.101",
        "resolver_name": "resolver-a1b2c3d4e5f6789012345678abcdef90",
        "state": "ACTIVE"
    }
}

1.21 - Show Public Domain Name

1.21.1 - 1.3

get /v1/public-domain-names/{public_domain_id}

Description

Public Domain Name 상세

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	public_domain_id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string	None

Responses

HTTP Code	Description	Schema
200	OK	PublicDomainDetailResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/public-domain-names/{public_domain_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Example HTTP response

Response 200

{
    "public_domain_name": {
        "address_type": "DOMESTIC",
        "auto_extension": true,
        "created_at": "2025-09-08T03:43:57Z",
        "created_by": "504f24f8111e42e0578f367acd2a149f",
        "description": "This is description",
        "domestic_address_en": "West Campus 1F, 125 Olympic-ro 35-gil, Songpa-gu, Seoul",
        "domestic_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동), 서관 1층",
        "domestic_first_address_en": "125 Olympic-ro 35-gil, Songpa-gu, Seoul",
        "domestic_first_address_ko": "서울특별시 송파구 올림픽로35길 125 (신천동)",
        "domestic_second_address_en": "West Campus 1F",
        "domestic_second_address_ko": "서관 1층",
        "expired_date": "2026-09-09T00:00:00Z",
        "id": "10fjkeweffpublicdomain3193rud543",
        "modified_at": "2026-02-09T08:00:40Z",
        "modified_by": "504f24f8111e42e0578f367acd2a149f",
        "name": "example.com",
        "overseas_address": "123 Main St, New York, NY 10001",
        "overseas_first_address": "123 Main St",
        "overseas_second_address": "New York",
        "overseas_third_address": "NY 10001",
        "postal_code": "12345",
        "register_email": "admin@example.com",
        "register_name_en": "Hong Gildong",
        "register_name_ko": "홍길동",
        "register_telno": "",
        "start_date": "2025-09-09T00:00:00Z",
        "status": "REGISTERED"
    }
}

1.22 - Transfer Public Domain Name

1.22.1 - 1.3

post /v1/public-domain-names/{public_domain_id}/transfer

Description

Public Domain Name을 다른 Account로 이관

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	public_domain_id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string	None
body	body required		PublicDomainTransferRequest

Responses

HTTP Code	Description	Schema
200	OK	PublicDomainTransferResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/public-domain-names/{public_domain_id}/transfer

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = dns 1.3"

Request body

{
    "target_account_id": "003dffc50eb123a1cbf4f2e5c71d4f15",
    "type": "REQUEST"
}

Example HTTP response

Response 200

{
    "auto_extension": true,
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "This is description",
    "expired_date": "2026-09-09T00:00:00Z",
    "id": "10fjkeweffpublicdomain3193rud543",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "example.com",
    "start_date": "2025-09-09T00:00:00Z",
    "state": "TRANSFER_REQUESTED"
}

2 - Models

2.1 - CreatePublicDomainRequest

Name	Description	Schema	Default
address_type required	도메인 등록 주소 유형 Example :	string
auto_extension optional	도메인 자동 연장 활성화 여부 Example : `True`	any of [boolean, null]	True
description optional	설명 Example : `This is description`	any of [string, null]
domestic_first_address_en required	국내 주소 1 (EN) Example : `125 Olympic-ro 35-gil, Songpa-gu, Seoul`	string
domestic_first_address_ko required	국내 주소 1 (KO) Example : `서울특별시 송파구 올림픽로35길 125 (신천동)`	string
domestic_second_address_en required	국내 주소 2 (EN) Example : `West Campus 1F`	any of [string, null]
domestic_second_address_ko required	국내 주소 2 (KO) Example : `서관 1층` Maximum length : `16`	string
name required	Public Domain Name 이름 Example : `example.com` Minimum length : `2` Maximum length : `63`	string
overseas_first_address required	해외 주소 첫 번째 줄 Example : `123 Main St`	any of [string, null]
overseas_second_address required	해외 주소 두 번째 줄 Example : `New York`	any of [string, null]
overseas_third_address required	해외 주소 세 번째 줄 Example : `NY 10001`	any of [string, null]
postal_code required	도메인 등록 우편번호 Example : `12345` Maximum length : `6`	string
register_email required	도메인 등록자 이메일 주소 Example : `admin@example.com` Pattern : `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$` Minimum length : `6` Maximum length : `64`	string
register_name_en required	도메인 등록자 이름(영문) Example : `Hong Gildong` Minimum length : `1` Maximum length : `30`	string
register_name_ko required	도메인 등록자 이름(국문) Example : `홍길동` Minimum length : `1` Maximum length : `30`	string
register_telno required	도메인 등록자 전화번호 Example :	string
tags optional	태그 목록 Example : `[{'key': 'env', 'value': 'prod'}]`	array[Tag]

2.2 - CreatePublicDomainResponse

Name	Description	Schema	Default
public_domain_name required		PublicDomainDetail

2.3 - HostedZoneCreateRequestV1Dot3

Name	Description	Schema
description optional	설명 Example : `This is description`	any of [string, null]
name required	DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. Example : `my-zone.com` Minimum length : `2` Maximum length : `69`	string
private_dns_id optional	Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. Example : `fedcba9876543210fedcba9876543210`	any of [string, null]
tags optional	태그 목록	array[Tag]
type required	Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) Example : `private`	enum (public, private)

2.4 - HostedZoneListResponseV1Dot3

Name	Description	Schema
count required	count Example : `20`	integer
hosted_zones required	Hosted Zone 목록	array[HostedZoneV1Dot3]
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.5 - HostedZoneSetRequestV1Dot3

Name	Description	Schema	Default
description optional	설명 Example : `This is description`	any of [string, null]

2.6 - HostedZoneShowResponseV1Dot3

Name	Description	Schema
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `This is description`	any of [string, null]
hosted_zone_type optional	Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) Example : `public`	enum (public, private)
id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. Example : `my-zone.com`	string
pool_id required	Hosted Zone에 연결된 리소스 풀 ID Example : `12345678-90ab-cdef-1234-567890abcdef`	string
private_dns_id optional	Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. Example : `fedcba9876543210fedcba9876543210`	any of [string, null]
private_dns_name optional	Hosted Zone 등록을 위한 DNS 서버 이름입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. Example : `private-dns01`	any of [string, null]
status required	상태 Example : `CREATING`	enum (CREATING, EDITING, ACTIVE, DELETING, DELETED, ERROR, PENDING, UNKNOWN)
ttl optional	이 존의 DNS 레코드에 대한 TTL(초 단위) 값 Example : `3600`	any of [integer, null]

2.7 - HostedZoneV1Dot3

Name	Description	Schema
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `This is description`	any of [string, null]
hosted_zone_type optional	Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) Example : `public`	enum (public, private)
id required	Hosted Zone의 고유 식별자 Example : `3432012nfdksdf03ktrld9234lgfg`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. Example : `my-zone.com`	string
pool_id required	Hosted Zone에 연결된 리소스 풀 ID Example : `12345678-90ab-cdef-1234-567890abcdef`	string
private_dns_id optional	Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. Example : `fedcba9876543210fedcba9876543210`	any of [string, null]
private_dns_name optional	Hosted Zone 등록을 위한 DNS 서버 이름입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. Example : `private-dns01`	any of [string, null]
status required	상태 Example : `CREATING`	enum (CREATING, EDITING, ACTIVE, DELETING, DELETED, ERROR, PENDING, UNKNOWN)
ttl optional	이 존의 DNS 레코드에 대한 TTL(초 단위) 값 Example : `3600`	any of [integer, null]

2.8 - PrivateDns

Name	Description	Schema
auth_dns_name required	Private DNS의 권한 있는(authoritative) DNS 이름 Example : `authdns-a1b2c3d4e5f6789012345678abcdef90`	any of [string, null]
connected_vpc_ids optional	이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. Example : `['1234567890abcdef1234567890abcdef', 'fedcba0987654321fedcba0987654321']`	array[string]
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `This is description`	any of [string, null]
id required	프라이빗 DNS의 고유 식별자 Example : `fedcba9876543210fedcba9876543210`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Private DNS 이름 Example : `private-dns01`	string
pool_id required	Private DNS에 연결된 리소스 풀 식별자 Example : `12345678-90ab-cdef-1234-567890abcdef`	any of [string, null]
pool_name required	리소스 풀 이름 Example : `private01-a1b2c3d4e5f6789012345678abcdef90`	any of [string, null]
registered_region required	프라이빗 DNS가 등록된 리전 Example : `KR-WEST1`	any of [string, null]
resolver_ip required	DNS resolver IP 주소 Example : `198.19.0.101`	any of [string, null]
resolver_name required	DNS resolver 이름 Example : `resolver-a1b2c3d4e5f6789012345678abcdef90`	any of [string, null]
state required	상태 Example : `ACTIVE`	enum (CREATING, EDITING, ACTIVE, ACTIVATING, INACTIVE, DELETING, DELETED, ERROR, PENDING)

2.9 - PrivateDnsActivateRequest

Name	Description	Schema	Default
name required	Private DNS 이름 Example : `private-dns01` Pattern : `^[a-zA-Z0-9-]$` Minimum length* : `3` Maximum length : `20`	string

2.10 - PrivateDnsCreateRequest

Name	Description	Schema
connected_vpc_ids optional	이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. Example : `['1234567890abcdef1234567890abcdef', 'fedcba0987654321fedcba0987654321']`	array[string]
description optional	설명 Example : `This is description`	any of [string, null]
name required	Private DNS 이름 Example : `private-dns01` Pattern : `^[a-zA-Z0-9-]$` Minimum length* : `3` Maximum length : `20`	string
tags optional	태그 목록 Example : `[{'key': 'env', 'value': 'prod'}]`	any of [array[Tag], null]

2.11 - PrivateDnsListResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
private_dns required		array[PrivateDns]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.12 - PrivateDnsSetRequest

Name	Description	Schema	Default
connected_vpc_ids optional	이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. Example : `['1234567890abcdef1234567890abcdef', 'fedcba0987654321fedcba0987654321']`	any of [array[string], null]
description optional	설명 Example : `This is description`	any of [string, null]

2.13 - PrivateDnsShowResponse

Name	Description	Schema	Default
private_dns required		PrivateDns

2.14 - PubblicDomainWhoisInfoUpdateRequest

Name	Description	Schema
address_type required	도메인 등록 주소 유형 Example :	string
domestic_first_address_en required	국내 주소 1 (EN) Example : `125 Olympic-ro 35-gil, Songpa-gu, Seoul`	string
domestic_first_address_ko required	국내 주소 1 (KO) Example : `서울특별시 송파구 올림픽로35길 125 (신천동)`	string
domestic_second_address_en required	국내 주소 2 (EN) Example : `West Campus 1F`	any of [string, null]
domestic_second_address_ko required	국내 주소 2 (KO) Example : `서관 1층` Maximum length : `16`	string
overseas_first_address required	해외 주소 첫 번째 줄 Example : `123 Main St`	any of [string, null]
overseas_second_address required	해외 주소 두 번째 줄 Example : `New York`	any of [string, null]
overseas_third_address required	해외 주소 세 번째 줄 Example : `NY 10001`	any of [string, null]
postal_code required	도메인 등록 우편번호 Example : `12345` Maximum length : `6`	string
register_email required	도메인 등록자 이메일 주소 Example : `admin@example.com` Pattern : `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$` Minimum length : `6` Maximum length : `64`	string
register_telno required	도메인 등록자 전화번호 Example :	string

2.15 - PublicDomainDetail

Name	Description	Schema
address_type required	도메인 등록 주소 유형 Example : `DOMESTIC`	string
auto_extension required	도메인 자동 연장 활성화 여부 Example : `True`	boolean
created_at required	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	string
created_by required	리소스를 생성한 사용자 ID Example : `504f24f8111e42e0578f367acd2a149f`	string
description optional	설명 Example : `This is description`	any of [string, null]
domestic_address_en required	도메인 등록 국내 주소(영문) Example : `West Campus 1F, 125 Olympic-ro 35-gil, Songpa-gu, Seoul`	string
domestic_address_ko required	도메인 등록 국내 주소(국문) Example : `서울특별시 송파구 올림픽로35길 125 (신천동), 서관 1층`	string
domestic_first_address_en required	국내 주소 1 (EN) Example : `125 Olympic-ro 35-gil, Songpa-gu, Seoul`	string
domestic_first_address_ko required	국내 주소 1 (KO) Example : `서울특별시 송파구 올림픽로35길 125 (신천동)`	string
domestic_second_address_en required	국내 주소 2 (EN) Example : `West Campus 1F`	string
domestic_second_address_ko required	국내 주소 2 (KO) Example : `서관 1층`	string
expired_date required	도메인 등록 만료일 Example : `2026-09-09T00:00:00Z`	string
id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string
modified_at required	리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	string
modified_by required	리소스를 마지막으로 수정한 사용자 ID Example : `504f24f8111e42e0578f367acd2a149f`	string
name required	Public Domain Name 이름 Example : `example.com`	string
overseas_address optional	도메인 등록 해외 주소 Example : `123 Main St, New York, NY 10001`	string
overseas_first_address required	해외 주소 첫 번째 줄 Example : `123 Main St`	string
overseas_second_address required	해외 주소 두 번째 줄 Example : `New York`	string
overseas_third_address required	해외 주소 세 번째 줄 Example : `NY 10001`	string
postal_code required	도메인 등록 우편번호 Example : `12345`	string
register_email required	도메인 등록자 이메일 주소 Example : `admin@example.com`	string
register_name_en required	도메인 등록자 이름(영문) Example : `Hong Gildong`	string
register_name_ko required	도메인 등록자 이름(국문) Example : `홍길동`	string
register_telno required	도메인 등록자 전화번호 Example :	string
start_date required	도메인 등록 시작일 Example : `2025-09-09T00:00:00Z`	string
status required	Public Domain Name의 현재 상태 Example : `REGISTERED`	string

2.16 - PublicDomainDetailResponse

Name	Description	Schema	Default
public_domain_name required		PublicDomainDetail

2.17 - PublicDomainListItem

Name	Description	Schema
created_at required	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	string
created_by required	리소스를 생성한 사용자 ID Example : `504f24f8111e42e0578f367acd2a149f`	string
expired_date required	도메인 등록 만료일 Example : `2026-09-09T00:00:00Z`	string
id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string
modified_at required	리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	string
modified_by required	리소스를 마지막으로 수정한 사용자 ID Example : `504f24f8111e42e0578f367acd2a149f`	string
name required	Public Domain Name 이름 Example : `example.com`	string
register_email required	도메인 등록자 이메일 주소 Example : `admin@example.com`	string
start_date required	도메인 등록 시작일 Example : `2025-09-09T00:00:00Z`	string
status required	Public Domain Name의 현재 상태 Example : `REGISTERED`	string

2.18 - PublicDomainListResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
public_domain_names required		array[PublicDomainListItem]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.19 - PublicDomainPartialUpdateRequest

Name	Description	Schema	Default
auto_extension optional	도메인 자동 연장 활성화 여부 Example : `True`	any of [boolean, null]
description optional	설명 Example : `This is description`	any of [string, null]

2.20 - PublicDomainPartialUpdateResponse

Name	Description	Schema
auto_extension optional	도메인 자동 연장 활성화 여부 Example : `True`	any of [boolean, null]
description optional	설명 Example : `This is description`	any of [string, null]
id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string

2.21 - PublicDomainTransferRequest

Name	Description	Schema	Default
target_account_id optional	대상 프로젝트 ID (type=REQUEST일 때 필수) Example : `003dffc50eb123a1cbf4f2e5c71d4f15`	any of [string, null]
type required	이전 작업 유형 Example : `REQUEST`	enum (REQUEST, CANCEL, APPROVE, REJECT)

2.22 - PublicDomainTransferResponse

Name	Description	Schema
auto_extension required	도메인 자동 연장 활성화 여부 Example : `True`	boolean
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description required	설명 Example : `This is description`	any of [string, null]
expired_date required	도메인 등록 만료일 Example : `2026-09-09T00:00:00Z`	string (date-time)
id required	Public Domain Name의 고유 식별자 Example : `10fjkeweffpublicdomain3193rud543`	string
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	Public Domain Name 이름 Example : `example.com`	string
start_date required	도메인 등록 시작일 Example : `2025-09-09T00:00:00Z`	string (date-time)
state required	상태 Example : `TRANSFER_REQUESTED`	enum (CREATING, REGISTERED, EXPIRED, DELETED, TRANSFER_REQUESTING, TRANSFER_REQUESTED, DELETING)

2.23 - PublicDomainWhoisInfoUpdateResponse

Name	Description	Schema
address_type required	도메인 등록 주소 유형 Example :	string
domestic_first_address_en required	국내 주소 1 (EN) Example : `125 Olympic-ro 35-gil, Songpa-gu, Seoul`	string
domestic_first_address_ko required	국내 주소 1 (KO) Example : `서울특별시 송파구 올림픽로35길 125 (신천동)`	string
domestic_second_address_en required	국내 주소 2 (EN) Example : `West Campus 1F`	any of [string, null]
domestic_second_address_ko required	국내 주소 2 (KO) Example : `서관 1층` Maximum length : `16`	string
name required	Public Domain Name 이름 Example : `example.com`	string
overseas_first_address required	해외 주소 첫 번째 줄 Example : `123 Main St`	any of [string, null]
overseas_second_address required	해외 주소 두 번째 줄 Example : `New York`	any of [string, null]
overseas_third_address required	해외 주소 세 번째 줄 Example : `NY 10001`	any of [string, null]
postal_code required	도메인 등록 우편번호 Example : `12345` Maximum length : `6`	string
register_email required	도메인 등록자 이메일 주소 Example : `admin@example.com` Pattern : `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$` Minimum length : `6` Maximum length : `64`	string
register_name_en required	도메인 등록자 이름(영문) Example : `Hong Gildong`	string
register_name_ko required	도메인 등록자 이름(국문) Example : `홍길동`	string
register_telno required	도메인 등록자 전화번호 Example :	string

2.24 - Record

Name	Description	Schema
action optional	DNS 레코드에 수행된 작업 Example : `CREATE`	any of [string, null]
created_at optional	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	any of [string, null]
description optional	설명 Example : `This is description`	any of [string, null]
id optional	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	any of [string, null]
links optional	Record 관련 링크 Example :	any of [object, null]
name optional	Record 이름 Example : `test.app`	any of [string, null]
project_id optional	DNS 레코드에 연결된 프로젝트 ID Example : `003dffc50eb123a1cbf4f2e5c71d4f15`	any of [string, null]
records optional	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	any of [array[string], null]
status optional	DNS 레코드의 현재 상태 Example : `ACTIVE`	any of [string, null]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]
type optional	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	any of [string, null]
updated_at optional	리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	any of [string, null]
version optional	Record 버전 Example : `1`	any of [integer, null]
zone_id optional	이 레코드를 포함하는 존의 ID Example : `3432012nfdksdf03ktrld9234lgfg`	any of [string, null]
zone_name optional	이 레코드를 포함하는 존의 이름 Example : `my-zone.com`	any of [string, null]

2.25 - RecordCreateRequest

Name	Description	Schema
description optional	설명 Example : `This is description`	any of [string, null]
name required	Record 이름 Example : `test.app` Minimum length : `1` Maximum length : `253`	string
records required	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	array[object]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]
type required	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	enum (A, AAAA, CNAME, TXT, SPF, MX)

2.26 - RecordCreateResponse

Name	Description	Schema
action optional	DNS 레코드에 수행된 작업 Example : `CREATE`	any of [string, null]
created_at optional	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	any of [string, null]
description optional	설명 Example : `This is description`	any of [string, null]
id optional	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	any of [string, null]
links optional	Record 관련 링크 Example :	any of [object, null]
name optional	Record 이름 Example : `test.app`	any of [string, null]
project_id optional	DNS 레코드에 연결된 프로젝트 ID Example : `003dffc50eb123a1cbf4f2e5c71d4f15`	any of [string, null]
records optional	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	any of [array[string], null]
status optional	DNS 레코드의 현재 상태 Example : `ACTIVE`	any of [string, null]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]
type optional	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	any of [string, null]
updated_at optional	리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	any of [string, null]
version optional	Record 버전 Example : `1`	any of [integer, null]
zone_id optional	이 레코드를 포함하는 존의 ID Example : `3432012nfdksdf03ktrld9234lgfg`	any of [string, null]
zone_name optional	이 레코드를 포함하는 존의 이름 Example : `my-zone.com`	any of [string, null]

2.27 - RecordListResponse

Name	Description	Schema
count optional	전체 개수 Example : `20`	any of [integer, null]
links optional	Record 관련 링크 Example :	any of [object, null]
metadata optional	전체 개수 Example :	any of [object, null]
records required	레코드 목록	array[Record]

2.28 - RecordSetRequest

Name	Description	Schema	Default
records optional	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	any of [array[object], null]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]

2.29 - RecordSetResponse

Name	Description	Schema
action optional	DNS 레코드에 수행된 작업 Example : `CREATE`	any of [string, null]
created_at optional	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	any of [string, null]
description optional	설명 Example : `This is description`	any of [string, null]
id optional	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	any of [string, null]
links optional	Record 관련 링크 Example :	any of [object, null]
name optional	Record 이름 Example : `test.app`	any of [string, null]
project_id optional	DNS 레코드에 연결된 프로젝트 ID Example : `003dffc50eb123a1cbf4f2e5c71d4f15`	any of [string, null]
records optional	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	any of [array[string], null]
status optional	DNS 레코드의 현재 상태 Example : `ACTIVE`	any of [string, null]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]
type optional	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	any of [string, null]
updated_at optional	리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	any of [string, null]
version optional	Record 버전 Example : `1`	any of [integer, null]
zone_id optional	이 레코드를 포함하는 존의 ID Example : `3432012nfdksdf03ktrld9234lgfg`	any of [string, null]
zone_name optional	이 레코드를 포함하는 존의 이름 Example : `my-zone.com`	any of [string, null]

2.30 - RecordShowResponse

Name	Description	Schema
action optional	DNS 레코드에 수행된 작업 Example : `CREATE`	any of [string, null]
created_at optional	리소스가 생성된 타임스탬프 (ISO 8601 형식) Example : `2025-09-08T03:43:57Z`	any of [string, null]
description optional	설명 Example : `This is description`	any of [string, null]
id optional	DNS 레코드의 고유 식별자 Example : `6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7`	any of [string, null]
links optional	Record 관련 링크 Example :	any of [object, null]
name optional	Record 이름 Example : `test.app`	any of [string, null]
project_id optional	DNS 레코드에 연결된 프로젝트 ID Example : `003dffc50eb123a1cbf4f2e5c71d4f15`	any of [string, null]
records optional	이 레코드의 데이터 목록 Example : `['12345.ns.private.kr-west1.dev2.samsungsdscloud.com']`	any of [array[string], null]
status optional	DNS 레코드의 현재 상태 Example : `ACTIVE`	any of [string, null]
ttl optional	DNS 레코드의 TTL(초 단위) 값 Example : `3600`	any of [integer, null]
type optional	DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) Example : `A`	any of [string, null]
updated_at optional	리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) Example : `2026-02-09T08:00:40Z`	any of [string, null]
version optional	Record 버전 Example : `1`	any of [integer, null]
zone_id optional	이 레코드를 포함하는 존의 ID Example : `3432012nfdksdf03ktrld9234lgfg`	any of [string, null]
zone_name optional	이 레코드를 포함하는 존의 이름 Example : `my-zone.com`	any of [string, null]

2.31 - Tag

Name	Description	Schema	Default
key required	tag key Example :	string
value required	tag value Example :	string