Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

atlas api accessTracking listAccessLogsByHostname

๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: ํ”ผ๋“œ๋ฐฑ ์ œ๊ณตํ•˜์„ธ์š”: ํด๋Ÿฌ์Šคํ„ฐ์˜ ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์œผ๋กœ ์‹๋ณ„๋˜๋Š” ํ•œ ํด๋Ÿฌ์Šคํ„ฐ์˜ ์•ก์„ธ์Šค ๋กœ๊ทธ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

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

์•ก์„ธ์Šค ๋กœ๊ทธ์—๋Š” ํด๋Ÿฌ์Šคํ„ฐ์— ๋Œ€ํ•œ ์ธ์ฆ ์š”์ฒญ ๋ชฉ๋ก์ด ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ํ…Œ๋„ŒํŠธ ๊ณ„์ธต ํด๋Ÿฌ์Šคํ„ฐ(M0, M2, M5)์—์„œ๋Š” ์ด ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ด ๋ฆฌ์†Œ์Šค๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์š”์ฒญ ์„œ๋น„์Šค ๊ณ„์ • ๋˜๋Š” API ํ‚ค์— ํ”„๋กœ์ ํŠธ ๋ชจ๋‹ˆํ„ฐ๋ง ๊ด€๋ฆฌ์ž ์—ญํ•  ๋˜๋Š” ํ”„๋กœ์ ํŠธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์•ก์„ธ์Šค ๊ด€๋ฆฌ์ž ์—ญํ• ์ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ด ๋ช…๋ น์€ ์ž๋™์œผ๋กœ 1 ์ƒ์„ฑ๋˜๋ฉฐ:1 Atlas API ์—”๋“œํฌ์ธํŠธ https://www.mongodb.com/ko-kr/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyhostname์— ํ•ด๋‹นํ•ฉ๋‹ˆ๋‹ค. .

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

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

--authResult

๊ฑฐ์ง“

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

--end

int

๊ฑฐ์ง“

๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ธฐ๋ก ๊ฒ€์ƒ‰์„ ์ค‘์ง€ํ•  ๋‚ ์งœ ๋ฐ ์‹œ๊ฐ„์ž…๋‹ˆ๋‹ค. ๋์„ ์ง€์ •ํ•˜๋Š” ๊ฒฝ์šฐ ์‹œ์ž‘๋„ ์ง€์ •ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” ์œ ๋‹‰์Šค ์‹œ๊ฐ„(๋ฐ€๋ฆฌ์ดˆ)์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

--envelope

envelope

๊ฑฐ์ง“

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

--groupId

๋ฌธ์ž์—ด

true

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

์ฐธ๊ณ : ๊ทธ๋ฃน๊ณผ ํ”„๋กœ์ ํŠธ๋Š” ๋™์˜์–ด์ž…๋‹ˆ๋‹ค. ๊ทธ๋ฃน ID๋Š” ํ”„๋กœ์ ํŠธ ID์™€ ๋™์ผํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ์กด ๊ทธ๋ฃน์˜ ๊ฒฝ์šฐ, ๊ทธ๋ฃน/ํ”„๋กœ์ ํŠธ ID๋Š” ๋™์ผํ•˜๊ฒŒ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ๋ฆฌ์†Œ์Šค ๋ฐ ํ•ด๋‹น ์—”๋“œํฌ์ธํŠธ๋Š” ๊ทธ๋ฃน์ด๋ผ๋Š” ์šฉ์–ด๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

-h, --help

๊ฑฐ์ง“

listAccessLogsByHostname์— ๋Œ€ํ•œ ๋„์›€๋ง

--hostname

๋ฌธ์ž์—ด

true

๋‹ค์šด๋กœ๋“œํ•˜๋ ค๋Š” ๋กœ๊ทธ ํŒŒ์ผ์„ ์ €์žฅํ•˜๋Š” MongoDB ํ˜ธ์ŠคํŠธ์˜ ์ •๊ทœํ™”๋œ ๋„๋ฉ”์ธ ์ด๋ฆ„ ๋˜๋Š” IP ์ฃผ์†Œ์ž…๋‹ˆ๋‹ค.

--ipAddress

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ธ์ฆ์„ ์‹œ๋„ํ•œ 1๊ฐœ ์ธํ„ฐ๋„ท ํ”„๋กœํ† ์ฝœ ์ฃผ์†Œ์ž…๋‹ˆ๋‹ค.

--nLogs

int

๊ฑฐ์ง“

๋ฐ˜ํ™˜ํ•  ๋กœ๊ทธ์˜ ์ตœ๋Œ€ ์ค„ ์ˆ˜์ž…๋‹ˆ๋‹ค.

-o, --output

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

--outputFile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

--pretty

๊ฑฐ์ง“

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

--start

int

๊ฑฐ์ง“

MongoDB ํด๋ผ์šฐ๋“œ๊ฐ€ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ธฐ๋ก์„ ์กฐํšŒํ•˜๊ธฐ ์‹œ์ž‘ํ•˜๋Š” ๋‚ ์งœ ๋ฐ ์‹œ๊ฐ„์ž…๋‹ˆ๋‹ค. ์‹œ์ž‘์„ ์ง€์ •ํ•˜๋Š” ๊ฒฝ์šฐ ๋๋„ ์ง€์ •ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” ์œ ๋‹‰์Šค ์‹œ๊ฐ„(๋ฐ€๋ฆฌ์ดˆ)์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

--version

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

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

-P, --profile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

atlas api accessTracking listAccessLogsByHostname --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --hostname [hostname]

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

listAccessLogsByClusterName

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