This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

CostExplorer

Overview

SCP CostExplorer Provides an Application Programming Interface (API) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of CostExplorer service and how to call API. The API is provided as a RESTful API, and it responds in JSON format.

Version

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

VersionStatusNot Before
1.1CURRENT-
1.0SUPPORTED20261119

OpenAPI URL

https://costexplorer.{environment}.samsungsdscloud.com

Environment and Region List

environmentregion
skr-west1
skr-east1
gkr-south1
gkr-south2
gkr-south3
ekr-west1
ekr-east1

1 - APIs

1.1 - GetPaymentMonthly

1.1.1 - 1.1

get /v1/payments/monthly

Description

Get payment monthly data.

State ACTIVE (CURRENT)

VersionNot Before
1.1-

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		Size
Example : 10
any of [integer, null]20
querypage
optional		Page
Example : 1
any of [integer, null]1

Responses

HTTP CodeDescriptionSchema
200OKOrgPaymentMonthlyResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/payments/monthly

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 1,
    "payments": [
        {
            "accumulated_unpaid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "bill_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "bill_currency": "KRW",
            "bill_year_month": "2024-08",
            "paid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "payer_account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "payer_account_name": "test-account",
            "payer_account_type": "MEMBER",
            "payment_currency": "KRW",
            "payment_date": "2024-08-01",
            "payment_state": "PAID",
            "suspended_year_month": "2024-08",
            "unpaid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "used_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "used_year_month": "2024-08"
        }
    ],
    "size": 10
}

1.1.2 - 1.0

get /v1/payments/monthly

Description

Get payment monthly data.

State ACTIVE (SUPPORTED)

VersionNot Before
1.020261119

Parameters

TypeNameDescriptionSchemaDefault
querysize
optional		Size
Example : 10
any of [integer, null]20
querypage
optional		Page
Example : 1
any of [integer, null]1

Responses

HTTP CodeDescriptionSchema
200OKOrgPaymentMonthlyResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/payments/monthly

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 1,
    "payments": [
        {
            "accumulated_unpaid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "bill_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "bill_currency": "KRW",
            "bill_year_month": "2024-08",
            "paid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "payer_account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "payer_account_name": "test-account",
            "payer_account_type": "MEMBER",
            "payment_currency": "KRW",
            "payment_date": "2024-08-01",
            "payment_state": "PAID",
            "suspended_year_month": "2024-08",
            "unpaid_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "used_amount": {
                "krw": "0.000",
                "usd": "0.00"
            },
            "used_year_month": "2024-08"
        }
    ],
    "size": 10
}

1.2 - ListBills

1.2.1 - 1.1

get /v1/bills

Description

Get bill list.

State ACTIVE (CURRENT)

VersionNot Before
1.1-

Parameters

TypeNameDescriptionSchemaDefault
querystart_year_month
optional		Start year-month (YYYY-mm)
Example : 2024-08
any of [string, null]None
queryend_year_month
optional		End year-month (YYYY-mm)
Example : 2024-08
any of [string, null]None
querywith_count
optional		with count
Example : true
any of [string, null]None
querylimit
optional		limit
Example : 20
any of [integer, null]None
querymarker
optional		marker
Example : 607e0938521643b5b4b266f343fae693
any of [string, null]None
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
queryaccount_id
optional		Account Id
Example : 228cb9e4a7934f84853594c7f26f7a21
any of [string, array[string], null]None
queryservice_category
optional		Service Category
Example : COMPUTE
any of [string, array[string], null]None
querybilling_item_id
optional		Billing Item Id
Example : VIRTUAL_SERVER
any of [string, array[string], null]None
queryresource_name
optional		Resource Name
Example : test-vm
any of [string, null]None
queryregion
optional		Region
Example : kr-west1
any of [string, array[string], null]None
querycontract_id
optional		Contract Id
Example : C002612775
any of [string, null]None
queryorder_status
optional		CCBS Order Status
Example : 04
any of [string, null]None
querybill_year_month
optional		Bill Date (YYYY-MM)
Example : 2024-07
any of [string, null]None
querybill_state
optional		Billing State
Example : USED
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKBillListResponseV1Dot1
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone
404Not FoundNone

Example HTTP request

Request path

/v1/bills

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.1"

Example HTTP response

Response 200

{
    "bills": [
        {
            "account_cost_savings": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "account_credit": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "adjust": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "amounts": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "asset": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "bill_state": "USED",
            "bill_year_month": "2024-07",
            "billing_item_id": "VIRTUAL_SERVER",
            "cancellation_fee": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "contract_id": "C002612775",
            "discount_amounts": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "edp": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "id": "5f3688a192094ddeb0c94166a3e88935",
            "msp_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "new_business_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "operation": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "option": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "order_status": "04",
            "package": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "partner_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "planned_compute": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "project_cost_savings": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "project_credit": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "region": "kr-west1",
            "reseller_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "resource_id": "7f6741f3-d9f0-4262-9a5f-627e373567a7",
            "resource_name": "test-vm",
            "sales_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "service_category": "COMPUTE",
            "sla_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "software": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "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"
            }
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ]
}

1.2.2 - 1.0

get /v1/bills

Description

Get bill list.

State ACTIVE (SUPPORTED)

VersionNot Before
1.020261119

Parameters

TypeNameDescriptionSchemaDefault
querystart_year_month
optional		Start year-month (YYYY-mm)
Example : 2024-08
any of [string, null]None
queryend_year_month
optional		End year-month (YYYY-mm)
Example : 2024-08
any of [string, null]None
querywith_count
optional		with count
Example : true
any of [string, null]None
querylimit
optional		limit
Example : 20
any of [integer, null]None
querymarker
optional		marker
Example : 607e0938521643b5b4b266f343fae693
any of [string, null]None
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
queryaccount_id
optional		Account Id
Example : 228cb9e4a7934f84853594c7f26f7a21
any of [string, array[string], null]None
queryservice_category
optional		Service Category
Example : COMPUTE
any of [string, array[string], null]None
querybilling_item_id
optional		Billing Item Id
Example : VIRTUAL_SERVER
any of [string, array[string], null]None
queryresource_name
optional		Resource Name
Example : test-vm
any of [string, null]None
queryregion
optional		Region
Example : kr-west1
any of [string, array[string], null]None
querycontract_id
optional		Contract Id
Example : C002612775
any of [string, null]None
queryorder_status
optional		CCBS Order Status
Example : 04
any of [string, null]None
querybill_year_month
optional		Bill Date (YYYY-MM)
Example : 2024-07
any of [string, null]None
querybill_state
optional		Billing State
Example : USED
any of [string, null]None

Responses

HTTP CodeDescriptionSchema
200OKBillListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone
404Not FoundNone

Example HTTP request

Request path

/v1/bills

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.0"

Example HTTP response

Response 200

{
    "bills": [
        {
            "account_cost_savings": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "account_credit": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "amounts": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "asset": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "bill_state": "USED",
            "bill_year_month": "2024-07",
            "billing_item_id": "VIRTUAL_SERVER",
            "cancellation_fee": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "contract_id": "C002612775",
            "discount_amounts": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "edp": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "id": "5f3688a192094ddeb0c94166a3e88935",
            "msp_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "new_business_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "operation": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "option": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "order_status": "04",
            "planned_compute": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "project_cost_savings": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "project_credit": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "region": "kr-west1",
            "reseller_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "resource_id": "7f6741f3-d9f0-4262-9a5f-627e373567a7",
            "resource_name": "test-vm",
            "sales_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "service_category": "COMPUTE",
            "sla_discount": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "support_plan": {
                "krw": "500.000",
                "usd": "0.000"
            },
            "usage_amt": ""
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ]
}

1.3 - ListUsages

1.3.1 - 1.1

get /v1/usages

Description

Get usage list.

State ACTIVE (CURRENT)

VersionNot Before
1.1-

Parameters

TypeNameDescriptionSchemaDefault
querystart_date
optional		Start date (YYYY-MM-dd)
Example : 2024-08-01
stringNone
queryend_date
optional		End date (YYYY-MM-dd)
Example : 2024-08-01
stringNone
querywith_count
optional		with count
Example : true
any of [string, null]None
querylimit
optional		LIMIT
Example :
any of [integer, null]None
querymarker
optional		marker
Example : 607e0938521643b5b4b266f343fae693
any of [string, null]None
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
queryaccount_id
optional		Account Id
Example : 228cb9e4a7934f84853594c7f26f7a21
any of [string, array[string], null]None
queryservice_category
optional		Service Category
Example : COMPUTE
any of [string, array[string], null]None
querybilling_item_id
optional		Billing Item Id
Example : VIRTUAL_SERVER
any of [string, array[string], null]None
queryresource_name
optional		Resource Name
Example : test-vm
any of [string, null]None
queryregion
optional		Region
Example : kr-west1
any of [string, array[string], null]None
querycontract_id
optional		Contract Id
Example : C002612775
any of [string, null]None
queryorder_status
optional		CCBS Order Status
Example : 04
any of [string, array[string], null]None

Responses

HTTP CodeDescriptionSchema
200OKUsageListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone

Example HTTP request

Request path

/v1/usages

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "timezone": "Asia/Seoul",
    "usages": [
        {
            "account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "amounts": {
                "krw": "500.0000000000",
                "usd": "0.0"
            },
            "billing_item_id": "VIRTUAL_SERVER",
            "ccbs_product_code": "PD00013862",
            "contract_id": "C002612775",
            "end_time": "2024-08-01 00:00:00",
            "id": "5f3688a192094ddeb0c94166a3e88935",
            "metrics": [
                {
                    "unit_price_description": "112원/GB",
                    "usage": "0",
                    "usage_unit": "DAY"
                }
            ],
            "order_status": "04",
            "resource_id": "7f6741f3-d9f0-4262-9a5f-627e373567a7",
            "service_category": "COMPUTE",
            "start_time": "2024-08-01 00:00:00",
            "status_code": "0",
            "usage_date": "2024-08-01T00:00:00",
            "used_time": "10"
        }
    ]
}

1.3.2 - 1.0

get /v1/usages

Description

Get usage list.

State ACTIVE (SUPPORTED)

VersionNot Before
1.020261119

Parameters

TypeNameDescriptionSchemaDefault
querystart_date
optional		Start date (YYYY-MM-dd)
Example : 2024-08-01
stringNone
queryend_date
optional		End date (YYYY-MM-dd)
Example : 2024-08-01
stringNone
querywith_count
optional		with count
Example : true
any of [string, null]None
querylimit
optional		LIMIT
Example :
any of [integer, null]None
querymarker
optional		marker
Example : 607e0938521643b5b4b266f343fae693
any of [string, null]None
querysort
optional		sort
Example : created_at:desc
any of [string, null]None
queryaccount_id
optional		Account Id
Example : 228cb9e4a7934f84853594c7f26f7a21
any of [string, array[string], null]None
queryservice_category
optional		Service Category
Example : COMPUTE
any of [string, array[string], null]None
querybilling_item_id
optional		Billing Item Id
Example : VIRTUAL_SERVER
any of [string, array[string], null]None
queryresource_name
optional		Resource Name
Example : test-vm
any of [string, null]None
queryregion
optional		Region
Example : kr-west1
any of [string, array[string], null]None
querycontract_id
optional		Contract Id
Example : C002612775
any of [string, null]None
queryorder_status
optional		CCBS Order Status
Example : 04
any of [string, array[string], null]None

Responses

HTTP CodeDescriptionSchema
200OKUsageListResponse
400Bad RequestNone
401UnauthorizedNone
403ForbiddenNone
404Not FoundNone

Example HTTP request

Request path

/v1/usages

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = costexplorer 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "timezone": "Asia/Seoul",
    "usages": [
        {
            "account_id": "228cb9e4a7934f84853594c7f26f7a21",
            "amounts": {
                "krw": "500.0000000000",
                "usd": "0.0"
            },
            "billing_item_id": "VIRTUAL_SERVER",
            "ccbs_product_code": "PD00013862",
            "contract_id": "C002612775",
            "end_time": "2024-08-01 00:00:00",
            "id": "5f3688a192094ddeb0c94166a3e88935",
            "metrics": [
                {
                    "unit_price_description": "112원/GB",
                    "usage": "0",
                    "usage_unit": "DAY"
                }
            ],
            "order_status": "04",
            "resource_id": "7f6741f3-d9f0-4262-9a5f-627e373567a7",
            "service_category": "COMPUTE",
            "start_time": "2024-08-01 00:00:00",
            "status_code": "0",
            "usage_date": "2024-08-01T00:00:00",
            "used_time": "10"
        }
    ]
}

2 - Models

2.1 - Amount

NameDescriptionSchemaDefault
krw
optional		KRW amount
Example : 0.000
any of [object, string]0.000
usd
optional		USD amount
Example : 0.00
any of [object, string]0.00

2.2 - BillListResponse

NameDescriptionSchemaDefault
bills
required
array[BillResponse]
count
optional		total count
Example : 20
any of [integer, null]
links
optional		links
Example : [{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]
any of [array[object], null]

2.3 - BillListResponseV1Dot1

NameDescriptionSchemaDefault
bills
required
array[BillResponseV1Dot1]
count
optional		total count
Example : 20
any of [integer, null]
links
optional		links
Example : [{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]
any of [array[object], null]

2.4 - BillResponse

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

2.5 - BillResponseV1Dot1

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

2.6 - OrgPaymentMonthlyResponse

NameDescriptionSchemaDefault
count
required		Count
Example : 20
integer
page
required		Page
Example : 1
integer
payments
optional
array[PaymentMonthlyFlatDataDto]
size
required		Size
Example : 10
integer

2.7 - PaymentMonthlyFlatDataDto

NameDescriptionSchemaDefault
accumulated_unpaid_amount
optional
any of [Amount, null]
bill_amount
optional
any of [Amount, null]
bill_currency
optional		Currency
Example : KRW
any of [string, null]krw
bill_year_month
optional		Bill year Month
Example : 2024-08
string
paid_amount
optional
any of [Amount, null]
payer_account_id
optional		Payer Account Id
Example : 228cb9e4a7934f84853594c7f26f7a21
string
payer_account_name
optional		Payer Account Name
Example : test-account
string
payer_account_type
optional		Payer Account Type
Example : MEMBER
string
payment_currency
optional		Currency
Example : KRW
any of [string, null]krw
payment_date
optional		Payment date
Example : 2024-08-01
any of [string, null]
payment_state
optional		Billing State
Example : PAID
any of [string, null]
suspended_year_month
optional		Year-Month (YYYY-mm)
Example : 2024-08
any of [string, null]
unpaid_amount
optional
any of [Amount, null]
used_amount
optional
any of [Amount, null]
used_year_month
optional		Year-Month (YYYY-mm)
Example : 2024-08
string

2.8 - UsageListResponse

NameDescriptionSchemaDefault
count
optional		total count
Example : 20
any of [integer, null]
links
optional		links
Example : [{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]
any of [array[object], null]
timezone
optional		Timezone
Example : Asia/Seoul
stringAsia/Seoul
usages
required
array[UsageResponse]

2.9 - UsageMetricOpenAPIDTO

NameDescriptionSchemaDefault
unit_price_description
optional		Unit price description
Example : 112원/GB
string
usage
optional		Usages
Example : 0
string0
usage_unit
optional		Usage Unit
Example : DAY
string

2.10 - UsageResponse

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