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

이 페이지의 일반 화면으로 돌아가기.

GSLB

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 GSLB 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

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

VersionStatusNot Before
1.1CURRENT-
1.0DEPRECATED20260531

CLI Version History

1.1

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

변경사항

  • [변경] gslb gslb create - 명령어가 변경되었습니다.
    • 실행 시, 아래와 같은 옵션이 추가되었습니다.:
      • --routing-control-enabled
  • [신규] gslb gslb regional routing list - 명령어가 추가되었습니다.
  • [신규] gslb gslb-regional-routing-set - 명령어가 추가되었습니다.

1.0

GSLB CLI가 출시되었습니다.

변경사항

  • [신규] gslb gslb list - 명령어가 추가되었습니다.
  • [신규] gslb gslb create - 명령어가 추가되었습니다.
  • [신규] gslb gslb show - 명령어가 추가되었습니다.
  • [신규] gslb gslb update - 명령어가 추가되었습니다.
  • [신규] gslb gslb delete - 명령어가 추가되었습니다.
  • [신규] gslb gslb-health-check update - 명령어가 추가되었습니다.
  • [신규] gslb gslb-resource list - 명령어가 추가되었습니다.
  • [신규] gslb gslb-resource update - 명령어가 추가되었습니다.

1 - CLIs

1.1 - CreateGslb

1.1.1 - 1.1

scp-cli gslb gslb create
--protocol <value>
--resources <value>
--name <value>
--env_usage <value>
--algorithm <value>
[--description <value>]
[--tags <value>]
[--health_check_interval <value>]
[--health_check_probe_timeout <value>]
[--health_check_user_id <value>]
[--health_check_user_password <value>]
[--receive_string <value>]
[--send_string <value>]
[--service_port <value>]
[--timeout <value>]

Description

여러 리전에 트래픽을 분산하는 GSLB 리소스를 생성합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
protocol
required		stringThe protocol used for health checks (e.g., ICMP, TCP, HTTP, HTTPS).https
resources
required		arrayGSLB 리소스 목록'{"description": "", "destination": "192.168.1.100", "region": "KR-WEST-1", "weight": 10}'
name
required		stringGSLB 이름example.gslb.e.samsungsdscloud.com
env_usage
required		stringThe environment usage type for the GSLB (e.g., PUBLIC).PUBLIC
algorithm
required		stringThe load balancing algorithm for GSLB traffic distribution (e.g., ROUND_ROBIN, RATIO).ROUND_ROBIN
description
optional		string설명Example Description for GSLB
tags
optional		array태그 목록'{"key": "", "value": ""}'
health_check_interval
optional		integerGSLB 헬스 체크 주기5
health_check_probe_timeout
optional		integerGSLB 헬스 체크 Probe 타임아웃5
health_check_user_id
optional		stringGSLB 헬스 체크 사용자 이름user
health_check_user_password
optional		stringGSLB 헬스 체크 비밀번호Passw0rd!
receive_string
optional		stringGSLB 헬스 체크 수신 문자열OK
send_string
optional		stringThe GSLB Health Check Send String. If no input is provided, it operates as a “GET /” request.GET /
service_port
optional		integerGSLB 헬스 체크 서비스 포트1
timeout
optional		integerGSLB 헬스 체크 타임아웃. Interval보다 커야 합니다.6

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)ROUND_ROBIN
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명Example Description for GSLB
env_usageGSLB의 환경 사용 유형(예: PUBLIC)PUBLIC
health_checkGSLB 엔드포인트 가용성 모니터링을 위한 헬스 체크 설정
linked_resource_count이 GSLB에 연결된 리소스 수2
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름example.gslb.e.samsungsdscloud.com
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)ACTIVE

1.1.2 - 1.0

scp-cli gslb gslb create
--protocol <value>
--resources <value>
--name <value>
--env_usage <value>
--algorithm <value>
[--description <value>]
[--tags <value>]
[--health_check_interval <value>]
[--health_check_probe_timeout <value>]
[--health_check_user_id <value>]
[--health_check_user_password <value>]
[--receive_string <value>]
[--send_string <value>]
[--service_port <value>]
[--timeout <value>]

Description

여러 리전에 트래픽을 분산하는 GSLB 리소스를 생성합니다.

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
protocol
required		stringThe protocol used for health checks (e.g., ICMP, TCP, HTTP, HTTPS).https
resources
required		array'{"description": "", "destination": "192.168.1.100", "disabled": false, "region": "KR-WEST-1", "weight": 10}'
name
required		stringGSLB 이름-
env_usage
required		stringThe environment usage type for the GSLB (e.g., PUBLIC).-
algorithm
required		stringThe load balancing algorithm for GSLB traffic distribution (e.g., ROUND_ROBIN, RATIO).-
description
optional		string설명-
tags
optional		array태그 목록'{"key": "", "value": ""}'
health_check_interval
optional		integerGSLB 헬스 체크 주기5
health_check_probe_timeout
optional		integerGSLB 헬스 체크 Probe 타임아웃5
health_check_user_id
optional		stringGSLB 헬스 체크 사용자 이름user
health_check_user_password
optional		stringGSLB 헬스 체크 비밀번호Passw0rd!
receive_string
optional		stringGSLB 헬스 체크 수신 문자열OK
send_string
optional		stringThe GSLB Health Check Send String. If no input is provided, it operates as a “GET /” request.GET /
service_port
optional		integerGSLB 헬스 체크 서비스 포트1
timeout
optional		integerGSLB 헬스 체크 타임아웃. Interval보다 커야 합니다.6

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
health_check
linked_resource_count이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)

1.2 - DeleteGslb

1.2.1 - 1.1

scp-cli gslb gslb delete
--gslb_id <value>

Description

GSLB 리소스를 삭제합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-

1.2.2 - 1.0

scp-cli gslb gslb delete
--gslb_id <value>

Description

GSLB 리소스를 삭제합니다.

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-

1.3 - ListGslbResources

1.3.1 - 1.1

scp-cli gslb gslb-resource list
--gslb_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]

Description

GSLB 리소스 목록

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
destinationGSLB 리소스의 대상 엔드포인트192.168.1.100
health_check_statusGSLB 리소스의 헬스 체크 상태(예: CONNECTED, DISCONNECTED)
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
regionGSLB 리소스가 위치한 리전KR-WEST-1
statusGSLB 리소스 사용 여부(예: ENABLE, DISABLE)
weight부하 분산 배분을 위한 가중치(0-100)10

1.3.2 - 1.0

scp-cli gslb gslb-resource list
--gslb_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]

Description

GSLB 리소스 목록

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
destinationGSLB 리소스의 대상 엔드포인트192.168.1.100
disabledGSLB 리소스 비활성화False
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
regionGSLB 리소스가 위치한 리전KR-WEST-1
weight부하 분산 배분을 위한 가중치(0-100)10

1.4 - ListGslbs

1.4.1 - 1.1

scp-cli gslb gslb list
[--size <value>]
[--page <value>]
[--sort <value>]
[--state <value>]
[--name <value>]

Description

GSLB 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc
state
optional		stringGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)-
name
optional		stringGSLB 이름-

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
linked_resource_count이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)

1.4.2 - 1.0

scp-cli gslb gslb list
[--size <value>]
[--page <value>]
[--sort <value>]
[--state <value>]
[--name <value>]

Description

GSLB 목록을 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc
state
optional		stringGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)-
name
optional		stringGSLB 이름-

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
linked_resource_count이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)

1.5 - ListGslbsRegionalRoutingControl

1.5.1 - 1.1

scp-cli gslb gslb regional routing list
[--size <value>]
[--page <value>]
[--sort <value>]
[--region <value>]
[--status <value>]
[--name <value>]

Description

GSLB 리전별 라우팅 제어 목록 조회

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc
region
optional		stringGSLB 리소스가 위치한 리전-
status
optional		****GSLB 리소스 사용 여부(예: ENABLE, DISABLE)-
name
optional		stringGSLB 이름-

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
linked_regional_resource_count리전 내 이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
regionGSLB 리소스가 위치한 리전
statusGSLB 리소스 사용 여부(예: ENABLE, DISABLE)

1.6 - SetGslb

1.6.1 - 1.1

scp-cli gslb gslb update
--gslb_id <value>
[--algorithm <value>]
[--description <value>]

Description

GSLB 리소스를 수정합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
algorithm
optional		stringThe load balancing algorithm for GSLB traffic distribution (e.g., ROUND_ROBIN, RATIO).ROUND_ROBIN
description
optional		string설명-

1.6.2 - 1.0

scp-cli gslb gslb update
--gslb_id <value>
[--algorithm <value>]
[--description <value>]

Description

GSLB 리소스를 수정합니다.

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
algorithm
optional		stringThe load balancing algorithm for GSLB traffic distribution (e.g., ROUND_ROBIN, RATIO).ROUND_ROBIN
description
optional		string설명-

1.7 - SetGslbHealthCheck

1.7.1 - 1.1

scp-cli gslb gslb-health-check update
--gslb_id <value>
--protocol <value>
[--health_check_interval <value>]
[--health_check_probe_timeout <value>]
[--health_check_user_id <value>]
[--health_check_user_password <value>]
[--receive_string <value>]
[--send_string <value>]
[--service_port <value>]
[--timeout <value>]

Description

GSLB 헬스 체크 설정

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
protocol
required		stringThe protocol used for health checks (e.g., ICMP, TCP, HTTP, HTTPS).https
health_check_interval
optional		integerGSLB 헬스 체크 주기5
health_check_probe_timeout
optional		integerGSLB 헬스 체크 Probe 타임아웃5
health_check_user_id
optional		stringGSLB 헬스 체크 사용자 이름user
health_check_user_password
optional		stringGSLB 헬스 체크 비밀번호Passw0rd!
receive_string
optional		stringGSLB 헬스 체크 수신 문자열OK
send_string
optional		stringThe GSLB Health Check Send String. If no input is provided, it operates as a “GET /” request.GET /
service_port
optional		integerGSLB 헬스 체크 서비스 포트1
timeout
optional		integerGSLB 헬스 체크 타임아웃. Interval보다 커야 합니다.6

1.7.2 - 1.0

scp-cli gslb gslb-health-check update
--gslb_id <value>
--protocol <value>
[--health_check_interval <value>]
[--health_check_probe_timeout <value>]
[--health_check_user_id <value>]
[--health_check_user_password <value>]
[--receive_string <value>]
[--send_string <value>]
[--service_port <value>]
[--timeout <value>]

Description

GSLB 헬스 체크 설정

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
protocol
required		stringThe protocol used for health checks (e.g., ICMP, TCP, HTTP, HTTPS).https
health_check_interval
optional		integerGSLB 헬스 체크 주기5
health_check_probe_timeout
optional		integerGSLB 헬스 체크 Probe 타임아웃5
health_check_user_id
optional		stringGSLB 헬스 체크 사용자 이름user
health_check_user_password
optional		stringGSLB 헬스 체크 비밀번호Passw0rd!
receive_string
optional		stringGSLB 헬스 체크 수신 문자열OK
send_string
optional		stringThe GSLB Health Check Send String. If no input is provided, it operates as a “GET /” request.GET /
service_port
optional		integerGSLB 헬스 체크 서비스 포트1
timeout
optional		integerGSLB 헬스 체크 타임아웃. Interval보다 커야 합니다.6

1.8 - SetGslbRegionalRoutingControl

1.8.1 - 1.1

scp-cli gslb gslb-regional-routing-set
--gslb_id <value>
--status <value>
--region <value>

Description

GSLB 리전별 라우팅 제어 설정을 업데이트합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
status
required		stringWhether to use the GSLB resource. (e.g., ENABLE, DISABLE)ENABLE
region
required		stringGSLB 리소스가 위치한 리전KR-WEST-1

1.9 - SetGslbResources

1.9.1 - 1.1

scp-cli gslb gslb-resource update
--gslb_id <value>
--resources <value>

Description

GSLB 리소스 설정

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
resources
required		arrayGSLB 리소스 목록'{"description": "", "destination": "192.168.1.100", "region": "KR-WEST-1", "weight": 10}'

1.9.2 - 1.0

scp-cli gslb gslb-resource update
--gslb_id <value>
--resources <value>

Description

GSLB 리소스 설정

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-
resources
required		array'{"description": "", "destination": "192.168.1.100", "disabled": false, "region": "KR-WEST-1", "weight": 10}'

1.10 - ShowGslb

1.10.1 - 1.1

scp-cli gslb gslb show
--gslb_id <value>

Description

특정 GSLB의 상세 정보를 조회합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
health_check
linked_resource_count이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)

1.10.2 - 1.0

scp-cli gslb gslb show
--gslb_id <value>

Description

특정 GSLB의 상세 정보를 조회합니다.

상태 ACTIVE (DEPRECATED)

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

버전최소 지원 보장일
1.020260531

Parameters

NameTypeDescriptionExample
gslb_id
required		stringGSLB의 고유 식별자-

Responses

NameDescriptionExample
idID0fdd87aab8cb46f59b7c1f81ed03fb3e
algorithmGSLB 트래픽 분산을 위한 부하 분산 알고리즘(예: ROUND_ROBIN, RATIO)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
env_usageGSLB의 환경 사용 유형(예: PUBLIC)
health_check
linked_resource_count이 GSLB에 연결된 리소스 수
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameGSLB 이름
stateGSLB의 현재 상태(예: ACTIVE, CREATING, EDITING, ERROR, DELETING)