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

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

Global CDN

Overview

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

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

Version

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

VersionStatusNot Before
1.0CURRENT-

CLI Version History

1.0

CDN CLI가 출시되었습니다.

변경사항

  • [신규] cdn cdn service list - 명령어가 추가되었습니다.
  • [신규] cdn cdn service create - 명령어가 추가되었습니다.
  • [신규] cdn cdn service detail - 명령어가 추가되었습니다.
  • [신규] cdn cdn service update - 명령어가 추가되었습니다.
  • [신규] cdn cdn service delete - 명령어가 추가되었습니다.
  • [신규] cdn cdn service start - 명령어가 추가되었습니다.
  • [신규] cdn cdn service stop - 명령어가 추가되었습니다.
  • [신규] cdn cdn service purge - 명령어가 추가되었습니다.
  • [신규] cdn description update - 명령어가 추가되었습니다.

1 - CLIs

1.1 - Create Cdn Service

1.1.1 - 1.0

scp-cli cdn cdn service create
--range_request_allowed <value>
--query_string_ignored <value>
--origin_hostname_type <value>
--name <value>
--forward_host_header <value>
--content_policy <value>
--cdn_service_domain_prefix <value>
--cdn_origin_protocol <value>
--cdn_origin_port <value>
--cdn_origin_hostname <value>
--caching_option <value>
--cache_key_hostname <value>
--cache_expiry_time <value>
[--cdn_service_origin_path <value>]
[--custom_forward_host_header <value>]
[--description <value>]
[--request_custom_headers <value>]
[--response_custom_headers <value>]
[--tags <value>]

Description

원본 서버의 콘텐츠를 엣지 로케이션을 통해 캐싱하고 배포하는 CDN 서비스 리소스를 생성합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
range_request_allowed
required		boolean콘텐츠 배포 시 범위 요청 허용 여부True
query_string_ignored
required		boolean콘텐츠 캐싱 시 쿼리 문자열 무시 여부True
origin_hostname_type
required		stringThe type of the origin hostname (e.g., DOMAIN, IP).-
name
required		stringCDN 서비스 이름test1
forward_host_header
required		stringThe host header forwarded to the origin server (e.g., ORIGIN_HOSTNAME, INCOMING_HOST_HEADER, CUSTOM).-
content_policy
required		stringThe content delivery policy for the CDN service (e.g., ONLY_VALIDATED_CONTENTS, ALL_CONTENTS).ONLY_VALIDATED_CONTENTS
cdn_service_domain_prefix
required		stringCDN 서비스 도메인 접두사global1
cdn_origin_protocol
required		stringThe protocol used to connect to the origin server (e.g., HTTP, HTTPS).HTTPS
cdn_origin_port
required		integer원본 서버 연결에 사용되는 포트443
cdn_origin_hostname
required		stringCDN이 콘텐츠를 가져오는 원본 서버의 호스트네임test.example.com
caching_option
required		stringThe caching option for the CDN content (e.g., CACHE, NO_CACHE, BYPASS_CACHE).CACHE
cache_key_hostname
required		stringThe hostname used as part of the cache key (e.g., ORIGIN_HOSTNAME, INCOMING_HOST_HEADER).-
cache_expiry_time
required		integer엣지 로케이션에 저장된 콘텐츠의 캐시 만료 시간(초)86400
cdn_service_origin_path
optional		stringCDN이 콘텐츠를 가져오는 원본 서버의 경로/test/global/
custom_forward_host_header
optional		string포워드 호스트 헤더가 CUSTOM으로 설정된 경우 원본으로 전달되는 커스텀 호스트 헤더-
description
optional		string설명추가 정보 입력 - 설명
request_custom_headers
optional		object원본 서버로 전달되는 요청에 추가되는 커스텀 헤더-
response_custom_headers
optional		object클라이언트로 반환되는 응답에 추가되는 커스텀 헤더-
tags
optional		array태그 목록'{"key": "", "value": ""}'

Responses

NameDescriptionExample
account_idAccount ID
resource_id리소스 ID
workflow_id요청을 처리하는 워크플로우 ID

1.2 - Delete Cdn Service

1.2.1 - 1.0

scp-cli cdn cdn service delete
--id <value>

Description

CDN 서비스 리소스 삭제

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-

1.3 - Detail Cdn Service

1.3.1 - 1.0

scp-cli cdn cdn service detail
--id <value>

Description

특정 CDN 서비스의 상세 정보를 조회합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-

Responses

NameDescriptionExample
idCDN 서비스의 고유 식별자
account_idAccount ID
cache_expiry_time엣지 로케이션에 저장된 콘텐츠의 캐시 만료 시간(초)
cache_key_hostname캐시 키의 일부로 사용되는 호스트네임(예: ORIGIN_HOSTNAME, INCOMING_HOST_HEADER)
caching_optionCDN 콘텐츠의 캐싱 옵션(예: CACHE, NO_CACHE, BYPASS_CACHE)
cdn_origin_hostnameCDN이 콘텐츠를 가져오는 원본 서버의 호스트네임
cdn_origin_port원본 서버 연결에 사용되는 포트
cdn_origin_protocol원본 서버 연결에 사용되는 프로토콜(예: HTTP, HTTPS)
cdn_service_activation_stateCDN 서비스 활성화 상태
cdn_service_config_versionCDN 서비스 설정 버전
cdn_service_domainCDN 서비스가 콘텐츠를 제공하는 도메인 이름
cdn_service_origin_pathCDN이 콘텐츠를 가져오는 원본 서버의 경로
cdn_service_stateCDN 서비스의 현재 상태(예: RUNNING, STOPPED, CREATING, DELETING)
content_policyCDN 서비스의 콘텐츠 배포 정책(예: ONLY_VALIDATED_CONTENTS, ALL_CONTENTS)
created_at리소스가 생성된 타임스탬프 (ISO 8601 형식)
created_by리소스를 생성한 사용자 ID
custom_forward_host_header포워드 호스트 헤더가 CUSTOM으로 설정된 경우 원본으로 전달되는 커스텀 호스트 헤더
description설명
forward_host_header원본 서버로 전달되는 호스트 헤더(예: ORIGIN_HOSTNAME, INCOMING_HOST_HEADER, CUSTOM)
modified_at리소스가 마지막으로 수정된 타임스탬프 (ISO 8601 형식)
modified_by리소스를 마지막으로 수정한 사용자 ID
nameCDN 서비스 이름
origin_hostname_type원본 호스트네임 유형(예: DOMAIN, IP)
query_string_ignored콘텐츠 캐싱 시 쿼리 문자열 무시 여부
range_request_allowed콘텐츠 배포 시 범위 요청 허용 여부
regionCDN 서비스가 제공되는 리전
request_custom_headers원본 서버로 전달되는 요청에 추가되는 커스텀 헤더
response_custom_headers클라이언트로 반환되는 응답에 추가되는 커스텀 헤더

1.4 - List Cdn Service

1.4.1 - 1.0

scp-cli cdn cdn service list
[--size <value>]
[--page <value>]
[--sort <value>]
[--created_by <value>]
[--name <value>]
[--cdn_service_domain <value>]
[--cdn_origin_hostname <value>]

Description

CDN 서비스 목록을 조회합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
size
optional		integersize20
page
optional		integerpage0
sort
optional		stringsortcreated_at:desc
created_by
optional		string리소스를 생성한 사용자 ID-
name
optional		stringCDN 서비스 이름-
cdn_service_domain
optional		stringCDN 서비스가 콘텐츠를 제공하는 도메인 이름-
cdn_origin_hostname
optional		stringCDN이 콘텐츠를 가져오는 원본 서버의 호스트네임-

Responses

NameDescriptionExample
idCDN 서비스의 고유 식별자
account_idAccount ID
cdn_origin_hostnameCDN이 콘텐츠를 가져오는 원본 서버의 호스트네임
cdn_service_domainCDN 서비스가 콘텐츠를 제공하는 도메인 이름
cdn_service_stateCDN 서비스의 현재 상태(예: RUNNING, STOPPED, CREATING, DELETING)
created_at생성 시간2024-05-17T00:23:17Z
created_by생성자90dddfc2b1e04edba54ba2b41539a9ac
description설명
modified_at수정 시간2024-05-17T00:23:17Z
modified_by수정자90dddfc2b1e04edba54ba2b41539a9ac
nameCDN 서비스 이름
regionCDN 서비스가 제공되는 리전

1.5 - Purge Cdn Service

1.5.1 - 1.0

scp-cli cdn cdn service purge
--id <value>
--target_url <value>
--target_content <value>
[--custom_url <value>]

Description

CDN 서비스의 캐시된 콘텐츠를 Purge합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-
target_url
required		stringThe target URL scope for the purge operation (e.g., ALL, CUSTOM).CUSTOM
target_content
required		stringThe target content type to purge (e.g., ALL_CONTENT, INVALIDATED_CONTENT).INVALIDATED_CONTENT
custom_url
optional		string대상 URL이 CUSTOM으로 설정된 경우 Purge할 커스텀 URL/test/

Responses

NameDescriptionExample
account_idAccount ID
resource_id리소스 ID
workflow_id요청을 처리하는 워크플로우 ID

1.6 - Start Cdn Service

1.6.1 - 1.0

scp-cli cdn cdn service start
--id <value>

Description

CDN 서비스를 시작합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-

Responses

NameDescriptionExample
account_idAccount ID
resource_id리소스 ID
workflow_id요청을 처리하는 워크플로우 ID

1.7 - Stop Cdn Service

1.7.1 - 1.0

scp-cli cdn cdn service stop
--id <value>

Description

CDN 서비스를 정지합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-

Responses

NameDescriptionExample
account_idAccount ID
resource_id리소스 ID
workflow_id요청을 처리하는 워크플로우 ID

1.8 - Update Cdn Service

1.8.1 - 1.0

scp-cli cdn cdn service update
--id <value>
--range_request_allowed <value>
--query_string_ignored <value>
--origin_hostname_type <value>
--forward_host_header <value>
--content_policy <value>
--cdn_origin_protocol <value>
--cdn_origin_port <value>
--cdn_origin_hostname <value>
--caching_option <value>
--cache_key_hostname <value>
--cache_expiry_time <value>
[--cdn_service_origin_path <value>]
[--custom_forward_host_header <value>]
[--request_custom_headers <value>]
[--response_custom_headers <value>]

Description

CDN 서비스 리소스 수정

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-
range_request_allowed
required		boolean콘텐츠 배포 시 범위 요청 허용 여부True
query_string_ignored
required		boolean콘텐츠 캐싱 시 쿼리 문자열 무시 여부True
origin_hostname_type
required		stringThe type of the origin hostname (e.g., DOMAIN, IP).-
forward_host_header
required		stringThe host header forwarded to the origin server (e.g., ORIGIN_HOSTNAME, INCOMING_HOST_HEADER, CUSTOM).-
content_policy
required		stringThe content delivery policy for the CDN service (e.g., ONLY_VALIDATED_CONTENTS, ALL_CONTENTS).ONLY_VALIDATED_CONTENTS
cdn_origin_protocol
required		stringThe protocol used to connect to the origin server (e.g., HTTP, HTTPS).HTTPS
cdn_origin_port
required		integer원본 서버 연결에 사용되는 포트443
cdn_origin_hostname
required		stringCDN이 콘텐츠를 가져오는 원본 서버의 호스트네임test.example.com
caching_option
required		stringThe caching option for the CDN content (e.g., CACHE, NO_CACHE, BYPASS_CACHE).CACHE
cache_key_hostname
required		stringThe hostname used as part of the cache key (e.g., ORIGIN_HOSTNAME, INCOMING_HOST_HEADER).-
cache_expiry_time
required		integer엣지 로케이션에 저장된 콘텐츠의 캐시 만료 시간(초)86400
cdn_service_origin_path
optional		stringCDN이 콘텐츠를 가져오는 원본 서버의 경로/test/global/
custom_forward_host_header
optional		string포워드 호스트 헤더가 CUSTOM으로 설정된 경우 원본으로 전달되는 커스텀 호스트 헤더-
request_custom_headers
optional		object원본 서버로 전달되는 요청에 추가되는 커스텀 헤더-
response_custom_headers
optional		object클라이언트로 반환되는 응답에 추가되는 커스텀 헤더-

1.9 - Update Description of Cdn Service

1.9.1 - 1.0

scp-cli cdn description update
--id <value>
--description <value>

Description

CDN 서비스 설명을 업데이트합니다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.0-

Parameters

NameTypeDescriptionExample
id
required		stringCDN 서비스의 고유 식별자-
description
required		string설명추가 정보 입력 - 설명