DNS
Overview
SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.
본 가이드는 DNS 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.
Version
Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.
| Version | Status | Not Before |
|---|
| 1.3 | CURRENT | - |
CLI Version History
1.3
- DNS CLI가 1.3 버전으로 업데이트 되었습니다.
- DNS CLI 1.0-1.2 버전은 DEPRECATED 되었습니다.
변경사항
- [변경]
dns hosted-zone create - 명령어가 변경되었습니다.- 실행 시,
--email 옵션이 삭제되었습니다.
- [변경]
dns hosted-zone show - 명령어가 변경되었습니다. - [변경]
dns hosted-zone update → dns hosted-zone set - 명령어가 변경되었습니다.- 실행 시,
--email 옵션이 삭제되었습니다.
- [변경]
dns hosted-zone-record list - 명령어가 변경되었습니다.- Zone apex 레코드 이름이 원본 그대로 표시됩니다 (
@. 표기법 미사용).
- [변경]
dns record create → dns hosted-zone-record create - 명령어가 변경되었습니다. - [변경]
dns record delete → dns hosted-zone-record delete - 명령어가 변경되었습니다. - [변경]
dns record list → dns hosted-zone-record list - 명령어가 변경되었습니다. - [변경]
dns record show → dns hosted-zone-record show - 명령어가 변경되었습니다. - [변경]
dns record update → dns hosted-zone-record set - 명령어가 변경되었습니다. - [신규]
dns public-domain-name-transfer update - 명령어가 추가되었습니다.
1.2
DNS CLI가 1.2 버전으로 업데이트 되었습니다.
변경사항
- [변경]
dns hosted-zone list - 명령어가 변경되었습니다.- 출력 시, 아래와 같은 필드가 추가됩니다.:
private_dns_name (Private DNS 이름 조회)
- [변경]
dns hosted-zone show - 명령어가 변경되었습니다.- 출력 시, 아래와 같은 필드가 추가됩니다.:
private_dns_name (Private DNS 이름 조회)
1.1
DNS CLI가 1.1 버전으로 업데이트 되었습니다.
변경사항
- [변경]
dns hosted_zone create → dns hosted-zone create - 명령어가 변경되었습니다. - [변경]
dns hosted_zone delete → dns hosted-zone delete - 명령어가 변경되었습니다. - [변경]
dns hosted_zone list → dns hosted-zone list - 명령어가 변경되었습니다. - [변경]
dns hosted_zone show → dns hosted-zone show - 명령어가 변경되었습니다. - [변경]
dns hosted_zone update → dns hosted-zone update - 명령어가 변경되었습니다. - [변경]
dns private_dns create → dns private-dns create - 명령어가 변경되었습니다.- 실행 시, 아래와 같은 옵션이 추가되었습니다.:
--registered-region--private-dns-cr-id
- [변경]
dns private_dns delete → dns private-dns delete - 명령어가 변경되었습니다. - [변경]
dns private_dns list → dns private-dns list - 명령어가 변경되었습니다. - [변경]
dns private_dns set → dns private-dns set - 명령어가 변경되었습니다. - [변경]
dns private_dns show → dns private-dns show - 명령어가 변경되었습니다. - [변경]
dns recordset create → dns record create - 명령어가 변경되었습니다. - [변경]
dns recordset delete → dns record delete - 명령어가 변경되었습니다. - [변경]
dns recordset list → dns record list - 명령어가 변경되었습니다.- Zone apex 레코드 이름이
@. 표기법으로 표시됩니다.
- [변경]
dns recordset show → dns record show - 명령어가 변경되었습니다. - [변경]
dns recordset update → dns record update - 명령어가 변경되었습니다. - [신규]
dns private-dns activate - 명령어가 추가되었습니다. - [신규]
dns public-domain-name create - 명령어가 추가되었습니다. - [신규]
dns public-domain-name list - 명령어가 추가되었습니다. - [신규]
dns public-domain-name show - 명령어가 추가되었습니다. - [신규]
dns public-domain-name update - 명령어가 추가되었습니다. - [신규]
dns public-domain-name-info update - 명령어가 추가되었습니다.
1.0
DNS CLI가 출시되었습니다.
변경사항
- [신규]
dns hosted_zone create - 명령어가 추가되었습니다. - [신규]
dns hosted_zone delete - 명령어가 추가되었습니다. - [신규]
dns hosted_zone list - 명령어가 추가되었습니다. - [신규]
dns hosted_zone show - 명령어가 추가되었습니다. - [신규]
dns hosted_zone update - 명령어가 추가되었습니다. - [신규]
dns private_dns create - 명령어가 추가되었습니다. - [신규]
dns private_dns delete - 명령어가 추가되었습니다. - [신규]
dns private_dns list - 명령어가 추가되었습니다. - [신규]
dns private_dns set - 명령어가 추가되었습니다. - [신규]
dns private_dns show - 명령어가 추가되었습니다. - [신규]
dns recordset create - 명령어가 추가되었습니다. - [신규]
dns recordset delete - 명령어가 추가되었습니다. - [신규]
dns recordset list - 명령어가 추가되었습니다. - [신규]
dns recordset show - 명령어가 추가되었습니다. - [신규]
dns recordset update - 명령어가 추가되었습니다.
1 - CLIs
1.1 - Activate Private DNS
1.1.1 - 1.3
scp-cli dns private-dns activate
--name <value>
Description
Private DNS 활성화
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
name required | string | Private DNS 이름 | private-dns01 |
Responses
| Name | Description | Example |
|---|
| id | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
| auth_dns_name | Private DNS의 권한 있는(authoritative) DNS 이름 | authdns-a1b2c3d4e5f6789012345678abcdef90 |
| connected_vpc_ids | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | [‘1234567890abcdef1234567890abcdef’, ‘fedcba0987654321fedcba0987654321’] |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | Private DNS 이름 | private-dns01 |
| pool_id | Private DNS에 연결된 리소스 풀 식별자 | 12345678-90ab-cdef-1234-567890abcdef |
| pool_name | 리소스 풀 이름 | private01-a1b2c3d4e5f6789012345678abcdef90 |
| registered_region | 프라이빗 DNS가 등록된 리전 | KR-WEST1 |
| resolver_ip | DNS resolver IP 주소 | 198.19.0.101 |
| resolver_name | DNS resolver 이름 | resolver-a1b2c3d4e5f6789012345678abcdef90 |
| state | 상태 | ACTIVE |
1.2 - Create Hosted Zone
1.2.1 - 1.3
scp-cli dns hosted-zone create
--type <value>
--name <value>
[--description <value>]
[--private_dns_id <value>]
[--tags <value>]
Description
도메인 이름 해석을 관리하는 DNS 레코드를 포함하는 Hosted Zone을 생성합니다.
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
type required | string | The type of the hosted zone (e.g., public or private). | private |
name required | string | DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. | my-zone.com |
description optional | string | 설명 | This is description |
private_dns_id optional | string | The DNS server ID for registering a Hosted Zone.For a Public‑type Hosted Zone, display it as an empty value. | fedcba9876543210fedcba9876543210 |
tags optional | array | 태그 목록 | '{"key": "", "value": ""}' |
Responses
| Name | Description | Example |
|---|
| id | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| hosted_zone_type | Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) | |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. | my-zone.com |
| pool_id | Hosted Zone에 연결된 리소스 풀 ID | 12345678-90ab-cdef-1234-567890abcdef |
| private_dns_id | Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | fedcba9876543210fedcba9876543210 |
| private_dns_name | Hosted Zone 등록을 위한 DNS 서버 이름입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | private-dns01 |
| status | 상태 | |
| ttl | 이 존의 DNS 레코드에 대한 TTL(초 단위) 값 | 3600 |
1.3 - Create Hosted Zone Record
1.3.1 - 1.3
scp-cli dns hosted-zone-record create
--hosted_zone_id <value>
--type <value>
--records <value>
--name <value>
[--description <value>]
[--ttl <value>]
Description
도메인 이름 해석을 관리하는 DNS 레코드 리소스를 생성합니다.
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
hosted_zone_id required | string | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
type required | string | The type of the DNS record (e.g., A, AAAA, CNAME, MX, TXT, SPF). | - |
records required | array | 이 레코드의 데이터 목록 | 12345.ns.private.kr-west1.dev2.samsungsdscloud.com |
name required | string | Record 이름 | test.app |
description optional | string | 설명 | This is description |
ttl optional | integer | The Time-To-Live (TTL) value in seconds for the DNS record. | 3600 |
Responses
| Name | Description | Example |
|---|
| id | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
| action | DNS 레코드에 수행된 작업 | CREATE |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| description | 설명 | This is description |
| links | Record 관련 링크 | |
| name | Record 이름 | test.app |
| project_id | DNS 레코드에 연결된 프로젝트 ID | 003dffc50eb123a1cbf4f2e5c71d4f15 |
| records | 이 레코드의 데이터 목록 | [‘12345.ns.private.kr-west1.dev2.samsungsdscloud.com’] |
| status | DNS 레코드의 현재 상태 | ACTIVE |
| ttl | DNS 레코드의 TTL(초 단위) 값 | 3600 |
| type | DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) | A |
| updated_at | 리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| version | Record 버전 | 1 |
| zone_id | 이 레코드를 포함하는 존의 ID | 3432012nfdksdf03ktrld9234lgfg |
| zone_name | 이 레코드를 포함하는 존의 이름 | my-zone.com |
1.4 - Create Private DNS
1.4.1 - 1.3
scp-cli dns private-dns create
--name <value>
[--connected_vpc_ids <value>]
[--description <value>]
[--tags <value>]
Description
내부 DNS 해석을 관리하는 프라이빗 DNS 인스턴스를 생성합니다.
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
name required | string | Private DNS 이름 | private-dns01 |
connected_vpc_ids optional | array | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | 1234567890abcdef1234567890abcdef |
description optional | string | 설명 | This is description |
tags optional | array | 태그 목록 | '{"key": "", "value": ""}' |
Responses
| Name | Description | Example |
|---|
| id | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
| auth_dns_name | Private DNS의 권한 있는(authoritative) DNS 이름 | authdns-a1b2c3d4e5f6789012345678abcdef90 |
| connected_vpc_ids | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | [‘1234567890abcdef1234567890abcdef’, ‘fedcba0987654321fedcba0987654321’] |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | Private DNS 이름 | private-dns01 |
| pool_id | Private DNS에 연결된 리소스 풀 식별자 | 12345678-90ab-cdef-1234-567890abcdef |
| pool_name | 리소스 풀 이름 | private01-a1b2c3d4e5f6789012345678abcdef90 |
| registered_region | 프라이빗 DNS가 등록된 리전 | KR-WEST1 |
| resolver_ip | DNS resolver IP 주소 | 198.19.0.101 |
| resolver_name | DNS resolver 이름 | resolver-a1b2c3d4e5f6789012345678abcdef90 |
| state | 상태 | ACTIVE |
1.5 - Create Public Domain Name
1.5.1 - 1.3
scp-cli dns public-domain-name create
--register_telno <value>
--register_name_ko <value>
--register_name_en <value>
--register_email <value>
--postal_code <value>
--overseas_third_address <value>
--overseas_second_address <value>
--overseas_first_address <value>
--name <value>
--domestic_second_address_ko <value>
--domestic_second_address_en <value>
--domestic_first_address_ko <value>
--domestic_first_address_en <value>
--address_type <value>
[--auto_extension <value>]
[--description <value>]
[--tags <value>]
Description
Public Domain Name 생성
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
register_telno required | string | 도메인 등록자 전화번호 | - |
register_name_ko required | string | 도메인 등록자 이름(국문) | 홍길동 |
register_name_en required | string | 도메인 등록자 이름(영문) | Hong Gildong |
register_email required | string | 도메인 등록자 이메일 주소 | admin@example.com |
postal_code required | string | 도메인 등록 우편번호 | 12345 |
overseas_third_address required | string | 해외 주소 세 번째 줄 | NY 10001 |
overseas_second_address required | string | 해외 주소 두 번째 줄 | New York |
overseas_first_address required | string | 해외 주소 첫 번째 줄 | 123 Main St |
name required | string | Public Domain Name 이름 | example.com |
domestic_second_address_ko required | string | 국내 주소 2 (KO) | 서관 1층 |
domestic_second_address_en required | string | 국내 주소 2 (EN) | West Campus 1F |
domestic_first_address_ko required | string | 국내 주소 1 (KO) | 서울특별시 송파구 올림픽로35길 125 (신천동) |
domestic_first_address_en required | string | 국내 주소 1 (EN) | 125 Olympic-ro 35-gil, Songpa-gu, Seoul |
address_type required | string | 도메인 등록 주소 유형 | - |
auto_extension optional | boolean | 도메인 자동 연장 활성화 여부 | True |
description optional | string | 설명 | This is description |
tags optional | array | 태그 목록 | '{"key": "", "value": ""}' |
Responses
| Name | Description | Example |
|---|
| id | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
| address_type | 도메인 등록 주소 유형 | DOMESTIC |
| auto_extension | 도메인 자동 연장 활성화 여부 | True |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| created_by | 리소스를 생성한 사용자 ID | 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 | 국내 주소 1 (EN) | 125 Olympic-ro 35-gil, Songpa-gu, Seoul |
| domestic_first_address_ko | 국내 주소 1 (KO) | 서울특별시 송파구 올림픽로35길 125 (신천동) |
| domestic_second_address_en | 국내 주소 2 (EN) | West Campus 1F |
| domestic_second_address_ko | 국내 주소 2 (KO) | 서관 1층 |
| expired_date | 도메인 등록 만료일 | 2026-09-09T00:00:00Z |
| modified_at | 리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| modified_by | 리소스를 마지막으로 수정한 사용자 ID | 504f24f8111e42e0578f367acd2a149f |
| name | Public Domain 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 | Public Domain Name의 현재 상태 | REGISTERED |
1.6 - Delete Hosted Zone
1.6.1 - 1.3
scp-cli dns hosted-zone delete
--hosted_zone_id <value>
Description
Hosted Zone 삭제
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
hosted_zone_id required | string | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
1.7 - Delete Hosted Zone Record
1.7.1 - 1.3
scp-cli dns hosted-zone-record delete
--record_id <value>
--hosted_zone_id <value>
Description
Hosted zone record 삭제
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
record_id required | string | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
hosted_zone_id required | string | 이 Record를 포함하는 Hosted Zone의 식별자 | 3432012nfdksdf03ktrld9234lgfg |
1.8 - Delete Private DNS
1.8.1 - 1.3
scp-cli dns private-dns delete
--private_dns_id <value>
Description
Private DNS 삭제
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
private_dns_id required | string | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
1.9 - List Hosted Zone Records
1.9.1 - 1.3
scp-cli dns hosted-zone-record list
--hosted_zone_id <value>
[--limit <value>]
[--marker <value>]
[--sort_dir <value>]
[--sort_key <value>]
[--name <value>]
[--exact_name <value>]
[--type <value>]
[--data <value>]
[--status <value>]
[--description <value>]
[--ttl <value>]
Description
Record 목록을 제공합니다.
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
hosted_zone_id required | string | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
limit optional | integer | 반환할 최대 항목 수 | - |
marker optional | string | 이전 페이지의 마지막 레코드 ID | - |
sort_dir optional | string | 목록의 정렬 방향(ASC 또는 DESC) | - |
sort_key optional | string | 정렬 기준 필드 | - |
name optional | string | Record 이름 | test.app |
exact_name optional | string | Record 이름 | test.app |
type optional | string | DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) | A |
data optional | string | DNS 레코드 필터링 데이터 | 12345.ns.private.kr-west1.dev2.samsungsdscloud.com |
status optional | string | DNS 레코드의 현재 상태 | ACTIVE |
description optional | string | 설명 | This is description |
ttl optional | integer | DNS 레코드의 TTL(초 단위) 값 | 3600 |
Responses
| Name | Description | Example |
|---|
| id | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
| action | DNS 레코드에 수행된 작업 | CREATE |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| description | 설명 | This is description |
| links | Record 관련 링크 | |
| name | Record 이름 | test.app |
| project_id | DNS 레코드에 연결된 프로젝트 ID | 003dffc50eb123a1cbf4f2e5c71d4f15 |
| records | 이 레코드의 데이터 목록 | [‘12345.ns.private.kr-west1.dev2.samsungsdscloud.com’] |
| status | DNS 레코드의 현재 상태 | ACTIVE |
| ttl | DNS 레코드의 TTL(초 단위) 값 | 3600 |
| type | DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) | A |
| updated_at | 리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| version | Record 버전 | 1 |
| zone_id | 이 레코드를 포함하는 존의 ID | 3432012nfdksdf03ktrld9234lgfg |
| zone_name | 이 레코드를 포함하는 존의 이름 | my-zone.com |
1.10 - List Hosted Zones
1.10.1 - 1.3
scp-cli dns hosted-zone list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--type <value>]
[--status <value>]
Description
Hosted zone 목록
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
size optional | integer | size | 20 |
page optional | integer | page | 0 |
sort optional | string | sort | created_at:desc |
name optional | string | DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. | my-zone.com |
type optional | **** | Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) | - |
status optional | **** | Hosted Zone의 현재 상태(예: ACTIVE, CREATING, DELETING) | - |
Responses
| Name | Description | Example |
|---|
| id | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| hosted_zone_type | Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) | |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. | my-zone.com |
| pool_id | Hosted Zone에 연결된 리소스 풀 ID | 12345678-90ab-cdef-1234-567890abcdef |
| private_dns_id | Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | fedcba9876543210fedcba9876543210 |
| private_dns_name | Hosted Zone 등록을 위한 DNS 서버 이름입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | private-dns01 |
| status | 상태 | |
| ttl | 이 존의 DNS 레코드에 대한 TTL(초 단위) 값 | 3600 |
1.11 - List Private DNS
1.11.1 - 1.3
scp-cli dns private-dns list
[--size <value>]
[--page <value>]
[--sort <value>]
[--id <value>]
[--name <value>]
[--vpc_id <value>]
[--state <value>]
Description
프라이빗 DNS 목록
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
size optional | integer | size | 20 |
page optional | integer | page | 0 |
sort optional | string | sort | created_at:desc |
id optional | string | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
name optional | string | Private DNS 이름 | private-dns01 |
vpc_id optional | string | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | 7df8abb4912e4709b1cb237daccca7a8 |
state optional | **** | 상태 | ACTIVE |
Responses
| Name | Description | Example |
|---|
| id | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
| auth_dns_name | Private DNS의 권한 있는(authoritative) DNS 이름 | authdns-a1b2c3d4e5f6789012345678abcdef90 |
| connected_vpc_ids | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | [‘1234567890abcdef1234567890abcdef’, ‘fedcba0987654321fedcba0987654321’] |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | Private DNS 이름 | private-dns01 |
| pool_id | Private DNS에 연결된 리소스 풀 식별자 | 12345678-90ab-cdef-1234-567890abcdef |
| pool_name | 리소스 풀 이름 | private01-a1b2c3d4e5f6789012345678abcdef90 |
| registered_region | 프라이빗 DNS가 등록된 리전 | KR-WEST1 |
| resolver_ip | DNS resolver IP 주소 | 198.19.0.101 |
| resolver_name | DNS resolver 이름 | resolver-a1b2c3d4e5f6789012345678abcdef90 |
| state | 상태 | ACTIVE |
1.12 - List Public Domain Names
1.12.1 - 1.3
scp-cli dns public-domain-name list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--created_by <value>]
Description
Public Domain Name 목록
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
size optional | integer | size | 20 |
page optional | integer | page | 0 |
sort optional | string | sort | created_at:desc |
name optional | string | Public Domain Name 이름 | example.com |
created_by optional | string | 리소스를 생성한 사용자 ID | 504f24f8111e42e0578f367acd2a149f |
Responses
| Name | Description | Example |
|---|
| id | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| created_by | 리소스를 생성한 사용자 ID | 504f24f8111e42e0578f367acd2a149f |
| expired_date | 도메인 등록 만료일 | 2026-09-09T00:00:00Z |
| modified_at | 리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| modified_by | 리소스를 마지막으로 수정한 사용자 ID | 504f24f8111e42e0578f367acd2a149f |
| name | Public Domain Name 이름 | example.com |
| register_email | 도메인 등록자 이메일 주소 | admin@example.com |
| start_date | 도메인 등록 시작일 | 2025-09-09T00:00:00Z |
| status | Public Domain Name의 현재 상태 | REGISTERED |
1.13 - Set Hosted Zone
1.13.1 - 1.3
scp-cli dns hosted-zone set
--hosted_zone_id <value>
[--description <value>]
Description
Hosted zone 업데이트
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
hosted_zone_id required | string | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
description optional | string | 설명 | This is description |
1.14 - Set Hosted Zone Record
1.14.1 - 1.3
scp-cli dns hosted-zone-record set
--record_id <value>
--hosted_zone_id <value>
[--records <value>]
[--ttl <value>]
Description
Hosted zone record 값 업데이트
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
record_id required | string | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
hosted_zone_id required | string | 이 Record를 포함하는 Hosted Zone의 식별자 | 3432012nfdksdf03ktrld9234lgfg |
records optional | array | 이 레코드의 데이터 목록 | 12345.ns.private.kr-west1.dev2.samsungsdscloud.com |
ttl optional | integer | The Time-To-Live (TTL) value in seconds for the DNS record. | 3600 |
1.15 - Set Private DNS
1.15.1 - 1.3
scp-cli dns private-dns set
--private_dns_id <value>
[--connected_vpc_ids <value>]
[--description <value>]
Description
Private DNS에 연결된 VPC 목록을 업데이트합니다.
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
private_dns_id required | string | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
connected_vpc_ids optional | array | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | 1234567890abcdef1234567890abcdef |
description optional | string | 설명 | This is description |
1.16 - Set Public Domain Name
1.16.1 - 1.3
scp-cli dns public-domain-name update
--public_domain_id <value>
[--auto_extension <value>]
[--description <value>]
Description
Public Domain Name 업데이트
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
public_domain_id required | string | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
auto_extension optional | boolean | 도메인 자동 연장 활성화 여부 | True |
description optional | string | 설명 | This is description |
1.17 - Set Public Domain Name Whois Info
1.17.1 - 1.3
scp-cli dns public-domain-name-info update
--public_domain_id <value>
--register_telno <value>
--register_email <value>
--postal_code <value>
--overseas_third_address <value>
--overseas_second_address <value>
--overseas_first_address <value>
--domestic_second_address_ko <value>
--domestic_second_address_en <value>
--domestic_first_address_ko <value>
--domestic_first_address_en <value>
--address_type <value>
Description
Public Domain Name Whois 정보 업데이트
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
public_domain_id required | string | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
register_telno required | string | 도메인 등록자 전화번호 | - |
register_email required | string | 도메인 등록자 이메일 주소 | admin@example.com |
postal_code required | string | 도메인 등록 우편번호 | 12345 |
overseas_third_address required | string | 해외 주소 세 번째 줄 | NY 10001 |
overseas_second_address required | string | 해외 주소 두 번째 줄 | New York |
overseas_first_address required | string | 해외 주소 첫 번째 줄 | 123 Main St |
domestic_second_address_ko required | string | 국내 주소 2 (KO) | 서관 1층 |
domestic_second_address_en required | string | 국내 주소 2 (EN) | West Campus 1F |
domestic_first_address_ko required | string | 국내 주소 1 (KO) | 서울특별시 송파구 올림픽로35길 125 (신천동) |
domestic_first_address_en required | string | 국내 주소 1 (EN) | 125 Olympic-ro 35-gil, Songpa-gu, Seoul |
address_type required | string | 도메인 등록 주소 유형 | - |
1.18 - Show Hosted Zone
1.18.1 - 1.3
scp-cli dns hosted-zone show
--hosted_zone_id <value>
Description
Hosted zone 상세
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
hosted_zone_id required | string | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
Responses
| Name | Description | Example |
|---|
| id | Hosted Zone의 고유 식별자 | 3432012nfdksdf03ktrld9234lgfg |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| hosted_zone_type | Hosted Zone 유형(예: 퍼블릭 또는 프라이빗) | |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | DNS 서비스가 관리하는 도메인 이름입니다. 해당 도메인 및 하위 도메인의 모든 DNS 레코드가 이 Hosted Zone에 저장되고 제공됩니다. | my-zone.com |
| pool_id | Hosted Zone에 연결된 리소스 풀 ID | 12345678-90ab-cdef-1234-567890abcdef |
| private_dns_id | Hosted Zone 등록을 위한 DNS 서버 ID입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | fedcba9876543210fedcba9876543210 |
| private_dns_name | Hosted Zone 등록을 위한 DNS 서버 이름입니다. 퍼블릭 유형의 Hosted Zone인 경우 빈 값으로 표시됩니다. | private-dns01 |
| status | 상태 | |
| ttl | 이 존의 DNS 레코드에 대한 TTL(초 단위) 값 | 3600 |
1.19 - Show Hosted Zone Record
1.19.1 - 1.3
scp-cli dns hosted-zone-record show
--record_id <value>
--hosted_zone_id <value>
Description
Hosted zone record 상세
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
record_id required | string | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
hosted_zone_id required | string | 이 Record를 포함하는 Hosted Zone의 식별자 | 3432012nfdksdf03ktrld9234lgfg |
Responses
| Name | Description | Example |
|---|
| id | DNS 레코드의 고유 식별자 | 6ed7bc1-4b05-3cc7-7105-c1b71f7f30a7 |
| action | DNS 레코드에 수행된 작업 | CREATE |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| description | 설명 | This is description |
| links | Record 관련 링크 | |
| name | Record 이름 | test.app |
| project_id | DNS 레코드에 연결된 프로젝트 ID | 003dffc50eb123a1cbf4f2e5c71d4f15 |
| records | 이 레코드의 데이터 목록 | [‘12345.ns.private.kr-west1.dev2.samsungsdscloud.com’] |
| status | DNS 레코드의 현재 상태 | ACTIVE |
| ttl | DNS 레코드의 TTL(초 단위) 값 | 3600 |
| type | DNS 레코드 유형(예: A, AAAA, CNAME, MX, TXT, SPF) | A |
| updated_at | 리소스가 마지막으로 업데이트된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| version | Record 버전 | 1 |
| zone_id | 이 레코드를 포함하는 존의 ID | 3432012nfdksdf03ktrld9234lgfg |
| zone_name | 이 레코드를 포함하는 존의 이름 | my-zone.com |
1.20 - Show Private DNS
1.20.1 - 1.3
scp-cli dns private-dns show
--private_dns_id <value>
Description
프라이빗 DNS 상세
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
private_dns_id required | string | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
Responses
| Name | Description | Example |
|---|
| id | 프라이빗 DNS의 고유 식별자 | fedcba9876543210fedcba9876543210 |
| auth_dns_name | Private DNS의 권한 있는(authoritative) DNS 이름 | authdns-a1b2c3d4e5f6789012345678abcdef90 |
| connected_vpc_ids | 이 프라이빗 DNS에 연결된 VPC ID 목록입니다. DNS에 연결된 VPC만 등록된 도메인 정보를 조회할 수 있습니다. | [‘1234567890abcdef1234567890abcdef’, ‘fedcba0987654321fedcba0987654321’] |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | Private DNS 이름 | private-dns01 |
| pool_id | Private DNS에 연결된 리소스 풀 식별자 | 12345678-90ab-cdef-1234-567890abcdef |
| pool_name | 리소스 풀 이름 | private01-a1b2c3d4e5f6789012345678abcdef90 |
| registered_region | 프라이빗 DNS가 등록된 리전 | KR-WEST1 |
| resolver_ip | DNS resolver IP 주소 | 198.19.0.101 |
| resolver_name | DNS resolver 이름 | resolver-a1b2c3d4e5f6789012345678abcdef90 |
| state | 상태 | ACTIVE |
1.21 - Show Public Domain Name
1.21.1 - 1.3
scp-cli dns public-domain-name show
--public_domain_id <value>
Description
Public Domain Name 상세
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
public_domain_id required | string | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
Responses
| Name | Description | Example |
|---|
| id | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
| address_type | 도메인 등록 주소 유형 | DOMESTIC |
| auto_extension | 도메인 자동 연장 활성화 여부 | True |
| created_at | 리소스가 생성된 타임스탬프 (ISO 8601 형식) | 2025-09-08T03:43:57Z |
| created_by | 리소스를 생성한 사용자 ID | 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 | 국내 주소 1 (EN) | 125 Olympic-ro 35-gil, Songpa-gu, Seoul |
| domestic_first_address_ko | 국내 주소 1 (KO) | 서울특별시 송파구 올림픽로35길 125 (신천동) |
| domestic_second_address_en | 국내 주소 2 (EN) | West Campus 1F |
| domestic_second_address_ko | 국내 주소 2 (KO) | 서관 1층 |
| expired_date | 도메인 등록 만료일 | 2026-09-09T00:00:00Z |
| modified_at | 리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식) | 2026-02-09T08:00:40Z |
| modified_by | 리소스를 마지막으로 수정한 사용자 ID | 504f24f8111e42e0578f367acd2a149f |
| name | Public Domain 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 | Public Domain Name의 현재 상태 | REGISTERED |
1.22 - Transfer Public Domain Name
1.22.1 - 1.3
scp-cli dns public-domain-name-transfer update
--public_domain_id <value>
--type <value>
[--target_account_id <value>]
Description
Public Domain Name을 다른 Account로 이관
상태
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
public_domain_id required | string | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
type required | string | 이전 작업 유형 | REQUEST |
target_account_id optional | string | Target account id (required when type=REQUEST) | 003dffc50eb123a1cbf4f2e5c71d4f15 |
Responses
| Name | Description | Example |
|---|
| id | Public Domain Name의 고유 식별자 | 10fjkeweffpublicdomain3193rud543 |
| auto_extension | 도메인 자동 연장 활성화 여부 | True |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| description | 설명 | This is description |
| expired_date | 도메인 등록 만료일 | 2026-09-09T00:00:00Z |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | Public Domain Name 이름 | example.com |
| start_date | 도메인 등록 시작일 | 2025-09-09T00:00:00Z |
| state | 상태 | TRANSFER_REQUESTED |