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

CostExplorer

1: CLIs

1.1: GetPaymentMonthly

1.1.1: 1.1
1.1.2: 1.0

1.2: ListBills

1.2.1: 1.1
1.2.2: 1.0

1.3: ListUsages

1.3.1: 1.1
1.3.2: 1.0

Overview

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

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

Version

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

Version	Status	Not Before
1.1	CURRENT	-
1.0	SUPPORTED	20261119

1 - CLIs

1.1 - GetPaymentMonthly

1.1.1 - 1.1

scp-cli costexplorer payment monthly show
[--size <value>]
[--page <value>]

Description

Get payment monthly data.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
size optional	integer	Size	`10`
page optional	integer	Page	`1`

Responses

Name	Description	Example
count	Count	20
page	Page	1
payments		[]
size	Size	10

1.1.2 - 1.0

scp-cli costexplorer payment monthly show
[--size <value>]
[--page <value>]

Description

Get payment monthly data.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.0	20261119

Parameters

Name	Type	Description	Example
size optional	integer	Size	`10`
page optional	integer	Page	`1`

Responses

Name	Description	Example
count	Count	20
page	Page	1
payments		[]
size	Size	10

1.2 - ListBills

1.2.1 - 1.1

scp-cli costexplorer bill list
[--start_year_month <value>]
[--end_year_month <value>]
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--account_id <value>]
[--service_category <value>]
[--billing_item_id <value>]
[--resource_name <value>]
[--region <value>]
[--contract_id <value>]
[--order_status <value>]
[--bill_year_month <value>]
[--bill_state <value>]

Description

Get bill list.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
start_year_month optional	string	Start year-month (YYYY-mm)	`2024-08`
end_year_month optional	string	End year-month (YYYY-mm)	`2024-08`
with_count optional	string	with count	`true`
limit optional	integer	limit	`20`
marker optional	string	marker	`607e0938521643b5b4b266f343fae693`
sort optional	string	sort	`created_at:desc`
account_id optional	string	Account Id	`228cb9e4a7934f84853594c7f26f7a21`
service_category optional	string	Service Category	`COMPUTE`
billing_item_id optional	string	Billing Item Id	`VIRTUAL_SERVER`
resource_name optional	string	Resource Name	`test-vm`
region optional	string	Region	`kr-west1`
contract_id optional	string	Contract Id	`C002612775`
order_status optional	string	CCBS Order Status	`04`
bill_year_month optional	string	Bill Date (YYYY-MM)	`2024-07`
bill_state optional	string	Billing State	`USED`

Responses

Name	Description	Example
id	Bill Id	5f3688a192094ddeb0c94166a3e88935
account_cost_savings	Account Cost Savings	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
account_credit	Account Credit	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
account_id	Account Id	228cb9e4a7934f84853594c7f26f7a21
adjust	요금 조정	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
amounts	Total Amounts	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
asset	Asset amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
bill_state	Billing State	USED
bill_year_month	Bill year Month	2024-07
billing_item_id	Billing Item Id	VIRTUAL_SERVER
cancellation_fee	해지 수수료	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
contract_id	Contract Id	C002612775
discount_amounts	Total Discount Amounts	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
edp	EDP	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
msp_discount	MSP 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
new_business_discount	신규 사업 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
operation	Operation amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
option	Option amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
order_status	CCBS Order Status	04
package	패키지 비용	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
partner_discount	파트너사 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
planned_compute	Planned Compute	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
project_cost_savings	Project Cost Savings	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
project_credit	Project Credit	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
region	Region	kr-west1
reseller_discount	리셀러 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
resource_id	Resource Id	7f6741f3-d9f0-4262-9a5f-627e373567a7
resource_name	Resource Name	test-vm
sales_discount	영업(기타) 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
service_category	Service Category	COMPUTE
sla_discount	SLA	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
software	S/W 비용	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
support_plan	Support Plan	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
trimmed	절사 금액	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
usage_amt
volume_discount	볼륨 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}

1.2.2 - 1.0

scp-cli costexplorer bill list
[--start_year_month <value>]
[--end_year_month <value>]
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--account_id <value>]
[--service_category <value>]
[--billing_item_id <value>]
[--resource_name <value>]
[--region <value>]
[--contract_id <value>]
[--order_status <value>]
[--bill_year_month <value>]
[--bill_state <value>]

Description

Get bill list.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.0	20261119

Parameters

Name	Type	Description	Example
start_year_month optional	string	Start year-month (YYYY-mm)	`2024-08`
end_year_month optional	string	End year-month (YYYY-mm)	`2024-08`
with_count optional	string	with count	`true`
limit optional	integer	limit	`20`
marker optional	string	marker	`607e0938521643b5b4b266f343fae693`
sort optional	string	sort	`created_at:desc`
account_id optional	string	Account Id	`228cb9e4a7934f84853594c7f26f7a21`
service_category optional	string	Service Category	`COMPUTE`
billing_item_id optional	string	Billing Item Id	`VIRTUAL_SERVER`
resource_name optional	string	Resource Name	`test-vm`
region optional	string	Region	`kr-west1`
contract_id optional	string	Contract Id	`C002612775`
order_status optional	string	CCBS Order Status	`04`
bill_year_month optional	string	Bill Date (YYYY-MM)	`2024-07`
bill_state optional	string	Billing State	`USED`

Responses

Name	Description	Example
id	Bill Id	5f3688a192094ddeb0c94166a3e88935
account_cost_savings	Account Cost Savings	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
account_credit	Account Credit	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
account_id	Account Id	228cb9e4a7934f84853594c7f26f7a21
amounts	Total Amounts	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
asset	Asset amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
bill_state	Billing State	USED
bill_year_month	Bill year Month	2024-07
billing_item_id	Billing Item Id	VIRTUAL_SERVER
cancellation_fee	해지 수수료	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
contract_id	Contract Id	C002612775
discount_amounts	Total Discount Amounts	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
edp	EDP	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
msp_discount	MSP 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
new_business_discount	신규 사업 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
operation	Operation amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
option	Option amount	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
order_status	CCBS Order Status	04
planned_compute	Planned Compute	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
project_cost_savings	Project Cost Savings	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
project_credit	Project Credit	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
region	Region	kr-west1
reseller_discount	리셀러 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
resource_id	Resource Id	7f6741f3-d9f0-4262-9a5f-627e373567a7
resource_name	Resource Name	test-vm
sales_discount	영업(기타) 할인	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
service_category	Service Category	COMPUTE
sla_discount	SLA	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
support_plan	Support Plan	{‘krw’: ‘500.000’, ‘usd’: ‘0.000’}
usage_amt

1.3 - ListUsages

1.3.1 - 1.1

scp-cli costexplorer usages list
[--start_date <value>]
[--end_date <value>]
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--account_id <value>]
[--service_category <value>]
[--billing_item_id <value>]
[--resource_name <value>]
[--region <value>]
[--contract_id <value>]
[--order_status <value>]

Description

Get usage list.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
start_date optional	string	Start date (YYYY-MM-dd)	`2024-08-01`
end_date optional	string	End date (YYYY-MM-dd)	`2024-08-01`
with_count optional	string	with count	`true`
limit optional	integer	LIMIT	-
marker optional	string	marker	`607e0938521643b5b4b266f343fae693`
sort optional	string	sort	`created_at:desc`
account_id optional	string	Account Id	`228cb9e4a7934f84853594c7f26f7a21`
service_category optional	string	Service Category	`COMPUTE`
billing_item_id optional	string	Billing Item Id	`VIRTUAL_SERVER`
resource_name optional	string	Resource Name	`test-vm`
region optional	string	Region	`kr-west1`
contract_id optional	string	Contract Id	`C002612775`
order_status optional	string	CCBS Order Status	`04`

Responses

Name	Description	Example
id	Usages Id	5f3688a192094ddeb0c94166a3e88935
account_id	Account Id	228cb9e4a7934f84853594c7f26f7a21
amounts	Amount	{‘krw’: ‘500.0000000000’, ‘usd’: ‘0.0’}
billing_item_id	Billing Item Id	VIRTUAL_SERVER
ccbs_product_code	CCBS Product Code	PD00013862
contract_id	Contract Id	C002612775
end_time	End time (YYYY-MM-DD HH:mm:ss)	2024-08-01 00:00:00
metrics
order_status	CCBS Order Status	04
resource_id	Resource Id	7f6741f3-d9f0-4262-9a5f-627e373567a7
service_category	Service Category	COMPUTE
start_time	Started time (YYYY-MM-DD HH:mm:ss)	2024-08-01 00:00:00
status_code	Usage status code	0
usage_date	Usage date	2024-08-01T00:00:00
used_time	Used time	10

1.3.2 - 1.0

scp-cli costexplorer usages list
[--start_date <value>]
[--end_date <value>]
[--with_count <value>]
[--limit <value>]
[--marker <value>]
[--sort <value>]
[--account_id <value>]
[--service_category <value>]
[--billing_item_id <value>]
[--resource_name <value>]
[--region <value>]
[--contract_id <value>]
[--order_status <value>]

Description

Get usage list.

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.0	20261119

Parameters

Name	Type	Description	Example
start_date optional	string	Start date (YYYY-MM-dd)	`2024-08-01`
end_date optional	string	End date (YYYY-MM-dd)	`2024-08-01`
with_count optional	string	with count	`true`
limit optional	integer	LIMIT	-
marker optional	string	marker	`607e0938521643b5b4b266f343fae693`
sort optional	string	sort	`created_at:desc`
account_id optional	string	Account Id	`228cb9e4a7934f84853594c7f26f7a21`
service_category optional	string	Service Category	`COMPUTE`
billing_item_id optional	string	Billing Item Id	`VIRTUAL_SERVER`
resource_name optional	string	Resource Name	`test-vm`
region optional	string	Region	`kr-west1`
contract_id optional	string	Contract Id	`C002612775`
order_status optional	string	CCBS Order Status	`04`

Responses

Name	Description	Example
id	Usages Id	5f3688a192094ddeb0c94166a3e88935
account_id	Account Id	228cb9e4a7934f84853594c7f26f7a21
amounts	Amount	{‘krw’: ‘500.0000000000’, ‘usd’: ‘0.0’}
billing_item_id	Billing Item Id	VIRTUAL_SERVER
ccbs_product_code	CCBS Product Code	PD00013862
contract_id	Contract Id	C002612775
end_time	End time (YYYY-MM-DD HH:mm:ss)	2024-08-01 00:00:00
metrics
order_status	CCBS Order Status	04
resource_id	Resource Id	7f6741f3-d9f0-4262-9a5f-627e373567a7
service_category	Service Category	COMPUTE
start_time	Started time (YYYY-MM-DD HH:mm:ss)	2024-08-01 00:00:00
status_code	Usage status code	0
usage_date	Usage date	2024-08-01T00:00:00
used_time	Used time	10