Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

Atlas API ์ฒญ๊ตฌ์„œ ๋ชฉ๋กInvoices

๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: ํ”ผ๋“œ๋ฐฑ ์ œ๊ณตํ•˜์„ธ์š”: MongoDB ์ง€์ •๋œ ์กฐ์ง ์— ๋ฐœํ–‰ํ•œ ๋ชจ๋“  ์ฒญ๊ตฌ์„œ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: MongoDB Atlas ๊ด€๋ฆฌ์ž API ์—์„œ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋œ Atlas API ํ•˜์œ„ ๋ช…๋ น์€ ๊ด€๋ฆฌ์ž API ์— ๋Œ€ํ•œ ์ „์ฒด ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜๋ฉฐ ํ˜„์žฌ ๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ๋กœ ์ œ๊ณต๋ฉ๋‹ˆ๋‹ค( ํ”ผ๋“œ๋ฐฑ https://feedback.mongodb.com/forums/930808-Atlas-cli). ๊ด€๋ฆฌ์ž API ๊ธฐ๋Šฅ์—๋Š” ์ž์ฒด ์ถœ์‹œํ•˜๋‹ค ์ˆ˜๋ช… ์ฃผ๊ธฐ๊ฐ€ ์žˆ์œผ๋ฉฐ, ์ด๋Š” ์ œ๊ณต๋œ API ์—”๋“œํฌ์ธํŠธ ๋ฌธ์„œ ๋งํฌ๋ฅผ ํ†ตํ•ด ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ๋ชฉ๋ก์—๋Š” ์ฒญ๊ตฌ์„œ ์ƒํƒœ์™€ ๊ด€๊ณ„์—†์ด ๋ชจ๋“  ์ฒญ๊ตฌ์„œ๊ฐ€ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค. ์ด ๋ฆฌ์†Œ์Šค๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด, ์š”์ฒญํ•˜๋Š” ์„œ๋น„์Šค ๊ณ„์ • ๋˜๋Š” API ํ‚ค์— ์กฐ์ง ์ฒญ๊ตฌ ๋ทฐ์–ด, ์กฐ์ง ์ฒญ๊ตฌ ๊ด€๋ฆฌ์ž ๋˜๋Š” ์กฐ์ง ์†Œ์œ ์ž ์—ญํ• ์ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์กฐ์ง ๊ฐ„ ์„ค์ •์ด ์žˆ๋Š” ๊ฒฝ์šฐ, ์กฐ์ง ์ฒญ๊ตฌ ๊ด€๋ฆฌ์ž ๋˜๋Š” ์กฐ์ง ์†Œ์œ ์ž ์—ญํ• ์ด ์žˆ์œผ๋ฉด ์—ฐ๊ฒฐ๋œ ์ฒญ๊ตฌ์„œ๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ฒญ๊ตฌ์„œ์˜ ์ด ๋ฏธ์ง€๊ธ‰ ๊ธˆ์•ก์„ ๊ณ„์‚ฐํ•˜๋ ค๋ฉด ๊ฐ ์ฒญ๊ตฌ์„œ์˜ ์ด ๋ฏธ์ง€๊ธ‰ ๊ธˆ์•ก์„ ํ•ฉ์‚ฐํ•ฉ๋‹ˆ๋‹ค. ์ฒญ๊ตฌ์„œ์— ํฌํ•จ๋œ ๊ฐ ๊ฒฐ์ œ์˜ ๋ฏธ์ง€๊ธ‰ ๊ธˆ์•ก์˜ ํ•ฉ๊ณ„๋กœ ๊ณ„์‚ฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ง€๋ถˆํ•ด์•ผ ํ•  ๊ธˆ์•ก์„ ๊ณ„์‚ฐํ•˜๋ ค๋ฉด totalBilledCents * unitPrice + salesTax - startingBalanceCents ์ˆ˜์‹์„ ์‚ฌ์šฉํ•˜์„ธ์š”.

์ด ๋ช…๋ น์€ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋˜๋ฉฐ 1 1 Atlas API ์—”๋“œํฌ์ธํŠธ https://www.mongodb.com/ko-kr/docs/atlas/reference/api-resources-spec/v2/# ํƒœ๊ทธ๋ฅผ ์ง€์ •ํ•˜๋‹ค/Invoices/๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ: ์— ํ•ด๋‹นํ•ฉ๋‹ˆ๋‹ค. operation/listInvoices.

์ž์„ธํ•œ ๋‚ด์šฉ๊ณผ ์˜ˆ์‹œ๋Š” ์œ„์— ๋งํฌ๋œ ์ฐธ์กฐ API ๋ฌธ์„œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๋ช…๋ น ๊ตฌ๋ฌธ
atlas api invoices listInvoices [options]
์ด๋ฆ„
์œ ํ˜•
ํ•„์ˆ˜ ์‚ฌํ•ญ
์„ค๋ช…

--envelope

envelope

๊ฑฐ์ง“

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ์‘๋‹ต์„ ์—”๋ฒจ๋กœํ”„ JSON ๊ฐ์ฒด ๋กœ ๋ž˜ํ•‘ํ• ์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค. ์ผ๋ถ€ API ํด๋ผ์ด์–ธํŠธ๋Š” HTTP ์‘๋‹ต ํ—ค๋” ๋˜๋Š” ์ƒํƒœ ์ฝ”๋“œ์— ์•ก์„ธ์Šค ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ด ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋ ค๋ฉด ์ฟผ๋ฆฌ ์—์„œ envelope=true ๋ฅผ ์„ค์ •ํ•˜๋‹ค . ๊ฒฐ๊ณผ ๋ชฉ๋ก์„ ๋ฐ˜ํ™˜ํ•˜๋Š” ์—”๋“œํฌ์ธํŠธ๋Š” ๊ฒฐ๊ณผ ๊ฐ์ฒด ์—”๋ฒจ๋กœํ”„๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ์‘๋‹ต ๋ณธ๋ฌธ์— ์ƒํƒœ ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.

--fromDate

๋ฌธ์ž์—ด

๊ฑฐ์ง“

startDates๊ฐ€ fromDate๋ณด๋‹ค ํฌ๊ฑฐ๋‚˜ ๊ฐ™์€ ์ฒญ๊ตฌ์„œ๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค. ์ƒ๋žตํ•˜๋ฉด ์ฒญ๊ตฌ์„œ ๋ฐ˜ํ™˜์ด ๊ฐ€์žฅ ์ด๋ฅธ startDate๋กœ ๋Œ์•„๊ฐ‘๋‹ˆ๋‹ค.

-h, --help

๊ฑฐ์ง“

listInvoices ๋„์›€๋ง

--includeCount

๊ฑฐ์ง“

์‘๋‹ต์ด ์‘๋‹ต์˜ ์ด ํ•ญ๋ชฉ ์ˆ˜(TotalCount)๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š”์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค.

--itemsPerPage

int

๊ฑฐ์ง“

ํŽ˜์ด์ง€๋‹น ์‘๋‹ต์ด ๋ฐ˜ํ™˜ํ•˜๋Š” ํ•ญ๋ชฉ ์ˆ˜์ž…๋‹ˆ๋‹ค.

--orderBy

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๋ฐ˜ํ™˜๋œ ์ธ๋ณด์ด์Šค๋ฅผ ์ฃผ๋ฌธํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋˜๋Š” ํ•„๋“œ์ž…๋‹ˆ๋‹ค. sortBy ๋งค๊ฐœ๋ณ€์ˆ˜์™€ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜์—ฌ ๊ฒฐ๊ณผ์˜ ์ˆœ์„œ๋ฅผ ์ œ์–ดํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

--orgId

๋ฌธ์ž์—ด

true

ํ”„๋กœ์ ํŠธ๊ฐ€ ํฌํ•จ๋œ ์กฐ์ง ์‹๋ณ„ํ•˜๋Š” ๊ณ ์œ ํ•œ 24-16์ง„์ˆ˜ ๋ฌธ์ž์—ด์ž…๋‹ˆ๋‹ค. ์ธ์ฆ๋œ ์‚ฌ์šฉ์ž๊ฐ€ ์•ก์„ธ์Šค ํ•  ์ˆ˜ ์žˆ๋Š” ๋ชจ๋“  ์กฐ์ง์„ ์กฐํšŒ ํ•˜๋ ค๋ฉด [/orgs](# ํƒœ๊ทธ๋ฅผ ์ง€์ •ํ•˜๋‹ค /Organizations/operation/listOrganizations) ์—”๋“œํฌ์ธํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

-o, --output

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๊ธฐ๋ณธ ์„ค์ • API ํ˜•์‹์€ ["JSON", go- Template] ์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ๊ฐ’์˜ ๊ธฐ๋ณธ๊ฐ’์€ "JSON" ์ž…๋‹ˆ๋‹ค.

--outputFile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

API ์ถœ๋ ฅ์„ ์“ฐ๊ธฐ (write) ํŒŒ์ผ ์ž…๋‹ˆ๋‹ค. ์ด ํ”Œ๋ž˜๊ทธ๋Š” ์—”๋“œํฌ์ธํŠธ์˜ ์ถœ๋ ฅ์ด ๋ฐ”์ด๋„ˆ๋ฆฌ(์˜ˆ: gzip)์ด๊ณ  ๋ช…๋ น์ด ํŒŒ์ดํ”„๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ(์˜ˆ: Atlas ๋ช…๋ น > out.zip)์— ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

--pageNum

int

๊ฑฐ์ง“

์‘๋‹ต์ด ๋ฐ˜ํ™˜ํ•˜๋Š” ์ „์ฒด ๊ฐ์ฒด์˜ ํ˜„์žฌ ์„ธํŠธ๋ฅผ ํ‘œ์‹œํ•˜๋Š” ํŽ˜์ด์ง€ ๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค.

--pretty

๊ฑฐ์ง“

์‘๋‹ต ๋ณธ๋ฌธ์ด ํ”„๋ฆฌํ‹ฐํ”„๋ฆฐํŠธ ํ˜•์‹์ด์–ด์•ผ ํ•˜๋Š”์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค.

--sortBy

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๋ฐ˜ํ™˜๋œ ์ธ๋ณด์ด์Šค๋ฅผ ์ •๋ ฌํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋˜๋Š” ํ•„๋“œ์ž…๋‹ˆ๋‹ค. orderBy ๋งค๊ฐœ๋ณ€์ˆ˜์™€ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋ฉด ๊ฒฐ๊ณผ์˜ ์ˆœ์„œ๋ฅผ ์ œ์–ดํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

--statusNames

๋ฌธ์ž์—ด ๋ฐฐ์—ด

๊ฑฐ์ง“

์กฐํšŒํ•  ์ฒญ๊ตฌ์„œ์˜ ์ƒํƒœ์ž…๋‹ˆ๋‹ค. ์ƒ๋žตํ•˜๋ฉด ๋ชจ๋“  ์ƒํƒœ์˜ ์ฒญ๊ตฌ์„œ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

--toDate

๋ฌธ์ž์—ด

๊ฑฐ์ง“

endDates๊ฐ€ toDate๋ณด๋‹ค ์ž‘๊ฑฐ๋‚˜ ๊ฐ™์€ ์ธ๋ณด์ด์Šค๋ฅผ ๊ฒ€์ƒ‰ํ•ฉ๋‹ˆ๋‹ค. ์ƒ๋žตํ•˜๋ฉด ๋ฐ˜ํ™˜๋˜๋Š” ์ธ๋ณด์ด์Šค๋Š” ์ตœ์‹  endDate๊นŒ์ง€ ํ™•์žฅ๋ฉ๋‹ˆ๋‹ค.

--version

๋ฌธ์ž์—ด

๊ฑฐ์ง“

API ํ˜ธ์ถœ ์‹œ ์‚ฌ์šฉํ•  API ๋ฒ„์ „ [์˜ต์…˜: "2023-01-01"], ๊ธฐ๋ณธ๊ฐ’์€ ์ตœ์‹  ๋ฒ„์ „ ๋˜๋Š” ํ”„๋กœํ•„ api_version ๊ตฌ์„ฑ ๊ฐ’( ์„ค์ •ํ•˜๋‹ค ๊ฒฝ์šฐ) ์ด ๊ฐ’ ๊ธฐ๋ณธ๊ฐ’์€ '2023-01-01".

--viewLinkedInvoices

๊ฑฐ์ง“

LinkedInvoices ํ•„๋“œ์— ์—ฐ๊ฒฐ๋œ ์ฒญ๊ตฌ์„œ๋ฅผ ๋ฐ˜ํ™˜ํ• ์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค.

์ด๋ฆ„
์œ ํ˜•
ํ•„์ˆ˜ ์‚ฌํ•ญ
์„ค๋ช…

-P, --profile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๊ตฌ์„ฑ ํŒŒ์ผ ์—์„œ ์‚ฌ์šฉํ•  ํ”„๋กœํ•„์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. Atlas CLI ์˜ ํ”„๋กœํ•„์— ๋Œ€ํ•ด ํ•™์Šต https://dochub.mongodb.org/core/atlas-cli-save-connection-settings๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

atlas api invoices listInvoices --version 2023-01-01 --fromDate 2023-01-01 --orderBy desc --orgId 4888442a3354817a7320eb61 --toDate 2023-01-01

๋Œ์•„๊ฐ€๊ธฐ

getInvoice

์ด ํŽ˜์ด์ง€์˜ ๋‚ด์šฉ