완전한 명령 가이드
Koneksi CLI는 엔진과 상호작용하고 작업을 관리하기 위한 다양한 명령을 제공합니다.
Koneksi CLI 명령어 참조
개요
Koneksi CLI는 Koneksi API 플랫폼과 상호 작용하기 위한 도구를 제공합니다. 이 가이드는 기능별 카테고리로 정리된 모든 사용 가능한 명령어를 나열합니다.
설정 명령어
koneksi config set
CLI 명령어 전체에서 사용할 기본 이메일 주소를 저장합니다. --email을 반복적으로 지정할 필요가 줄어듭니다.
koneksi config show
현재 저장된 기본 이메일 구성을 표시하여 어떤 계정이 활성화되어 있는지 확인할 수 있습니다.
koneksi config clear
저장된 기본 이메일을 제거합니다. 새로운 이메일이 설정될 때까지 향후 명령어에서는 --email을 명시적으로 요구합니다. 계정 전환 시 유용합니다.
인증 명령어
koneksi auth register
이름, 이메일, 비밀번호 등의 세부 정보를 제공하여 새로운 사용자 계정을 등록합니다.
koneksi auth verify-account
이메일 주소를 확인하여 새로 생성된 계정을 인증합니다. 로그인 전에 이 단계가 필요합니다.
koneksi auth resend-verification
원본 인증 코드가 분실되었거나 만료된 경우 이메일로 인증 코드를 다시 전송합니다.
koneksi auth login
이메일과 비밀번호를 사용하여 인증하고 세션 관리를 위한 액세스 및 새로고침 토큰을 획득합니다.
koneksi auth verify-otp
로그인 중 다중 인증(MFA)을 완료하기 위해 일회용 비밀번호(OTP)를 제공합니다.
koneksi auth forgot-password
이메일을 통해 재설정 코드를 요청하여 비밀번호 복구 프로세스를 시작합니다.
koneksi auth reset-password
재설정 코드를 제공하고 새 비밀번호를 생성하여 비밀번호 복구를 완료합니다.
koneksi auth revoke-token
계정의 모든 활성 새로고침 토큰을 취소합니다. 이는 모든 현재 세션을 로그아웃합니다.
설정 명령어
koneksi settings change-password
로그인한 상태에서 계정 비밀번호를 변경합니다.
koneksi settings update-config
기본 설정 및 기본값과 같은 저장된 사용자 설정을 업데이트합니다.
koneksi profile get
이메일, 역할, 설정을 포함한 사용자 프로필의 세부 정보를 검색하고 표시합니다.
MFA 설정
koneksi settings mfa generate-otp
인증 앱으로 MFA를 설정하기 위한 새로운 OTP 시크릿을 생성합니다.
koneksi settings mfa enable
계정에 MFA를 활성화하여 추가 보안 계층을 추가합니다.
koneksi settings mfa disable
더 이상 추가 OTP 인증을 원하지 않는 경우 MFA를 비활성화합니다.
서비스 계정 명령어
koneksi service-accounts generate
새로운 서비스 계정을 생성하고 API 자격 증명을 생성합니다.
koneksi service-accounts browse
조직과 연결된 모든 서비스 계정을 나열합니다.
koneksi service-accounts revoke
서비스 계정을 취소하거나 비활성화하여 추가 사용을 방지합니다.
피어 연결 명령어
koneksi peer fetch
네트워크 클러스터에서 현재 연결된 피어에 대한 정보를 검색합니다.
디렉토리 관리 명령어
koneksi directory create
저장소에 새로운 디렉토리를 생성합니다
koneksi directory read
파일과 하위 폴더를 포함한 디렉토리의 내용을 표시합니다.
koneksi directory update
디렉토리의 메타데이터(이름 변경)를 업데이트하거나 다른 위치로 이동합니다.
koneksi directory delete
디렉토리와 모든 내용을 영구적으로 삭제합니다.
koneksi directory upload
전체 로컬 폴더(하위 폴더와 파일 포함)를 Koneksi 저장소에 업로드합니다.
koneksi directory get-upload-queue
현재 업로드 대기열에 있는 디렉토리 목록을 표시합니다. 진행 상황 모니터링에 유용합니다.
koneksi directory delete-upload-queue
대기열에서 디렉토리 업로드 작업을 취소하고 제거합니다.
koneksi directory retry-upload
실패한 디렉토리 업로드 작업을 다시 시도합니다.
koneksi directory get-subdirectories
주어진 상위 디렉토리 아래의 모든 하위 디렉토리 ID를 나열합니다.
koneksi directory move-multiple
지정된 호스트 디렉토리 경로로 여러 디렉토리를 이동합니다
koneksi directory delete-multiple
여러 디렉토리를 영구적으로 삭제합니다
파일 관리 명령어
koneksi file upload
지정된 디렉토리에 단일 파일을 업로드합니다.
koneksi file read
메타데이터를 포함한 파일에 대한 자세한 정보를 검색합니다.
koneksi file update
파일 이름을 변경하거나 디렉토리 간에 이동합니다.
koneksi file delete
저장소에서 파일을 영구적으로 삭제합니다.
koneksi file download
파일을 로컬 시스템으로 다운로드합니다.
koneksi file get-shareable-url
파일 공유를 위한 지속적인 공개 URL을 생성합니다.
koneksi file generate-link
파일에 대한 임시 시간 제한 다운로드 링크를 생성합니다.
koneksi file share
파일을 다른 사용자와 직접 공유합니다.
koneksi file move-multiple
한 번의 작업으로 여러 파일을 대상 디렉토리로 이동합니다.
koneksi file delete-multiple
여러 파일을 일괄적으로 영구적으로 삭제합니다.
koneksi file ipfs-upload
IPFS의 지정된 디렉토리에 단일 파일을 업로드합니다.
관리자(Admin) 명령어
koneksi admin dashboard metrics
Koneksi 계정에서 시스템 리소스 사용량 메트릭을 검색하고 표시합니다
koneksi admin organizations list
시스템에 등록된 모든 조직을 나열합니다.
koneksi admin organizations create
새로운 조직 레코드를 생성합니다.
koneksi admin organizations read
특정 조직과 그 구성원의 세부 정보를 확인합니다.
koneksi admin organizations update
조직의 정보(이름, 도메인, 연락처, 정책 중 최소 하나)를 편집합니다.
koneksi admin organizations add-member
조직에 새로운 구성원을 추가합니다.
koneksi admin organizations update-member-role
조직 내 구성원의 역할을 변경합니다.
koneksi admin organizations remove-member
조직에서 구성원을 제거합니다
koneksi admin users list
시스템에 등록된 모든 사용자를 나열합니다
koneksi admin users create
관리자로 새로운 사용자 계정을 생성합니다.
koneksi admin users search
이메일로 사용자를 검색합니다
koneksi admin users read
사용자 ID로 사용자 세부 정보를 읽습니다
koneksi admin users update
사용자 ID로 사용자 세부 정보를 업데이트합니다
koneksi admin users update-limit
특정 사용자의 저장소 할당량/제한을 조정합니다.
koneksi admin realtime-backup list
관리자로서 시스템의 실시간 백업을 나열합니다
koneksi admin realtime-backup read
관리자로서 시스템의 실시간 백업을 읽습니다
koneksi admin realtime-backup toggle
관리자로서 시스템의 감시자를 활성화하거나 비활성화합니다
koneksi admin realtime-backup delete
관리자로서 시스템의 실시간 백업을 삭제합니다
koneksi admin realtime-backup clear
관리자로서 시스템의 실시간 백업을 지웁니다
koneksi admin recovery list
관리자로서 시스템의 복구 요청을 나열합니다
koneksi admin recovery read
관리자로서 시스템의 복구 요청을 읽습니다
koneksi admin recovery approve
관리자로서 시스템의 복구 요청을 승인합니다
koneksi admin recovery reject
관리자로서 시스템의 복구 요청을 거부합니다
조직 관리자(Organization Admin) 명령어
koneksi organization-admin dashboard metrics
조직의 사용 통계 및 메트릭을 확인합니다.
koneksi organization-admin members search
이름이나 이메일로 조직 내 구성원을 검색합니다.
koneksi organization-admin members create
조직에 새로운 구성원을 추가합니다.
koneksi organization-admin members update
역할이나 권한과 같은 구성원 세부 정보를 업데이트합니다.
koneksi organization-admin members read
특정 조직 구성원의 세부 정보를 확인합니다.
koneksi organization-admin members remove
조직에서 구성원을 제거합니다
koneksi organization-admin members list
조직의 모든 구성원을 나열합니다
koneksi organization-admin organization read
조직 수준 세부 정보와 현재 구성원을 검색합니다.
koneksi organization-admin organization update
조직의 프로필이나 구성을 업데이트합니다.
koneksi organization-admin realtime-backup list
조직 관리자 실시간 백업을 나열합니다
koneksi organization-admin realtime-backup read
조직 관리자 실시간 백업을 읽습니다
koneksi organization-admin realtime-backup toggle
조직 관리자 감시자를 토글합니다
koneksi organization-admin realtime-backup delete
조직 관리자 실시간 백업을 삭제합니다
koneksi organization-admin realtime-backup clear
조직 관리자 구성 위치를 지웁니다
koneksi organization-admin recovery approve
조직 관리자로서 시스템의 복구 요청을 승인합니다
koneksi organization-admin recovery list
조직 관리자로서 시스템의 복구 요청을 나열합니다
koneksi organization-admin recovery read
조직 관리자로서 시스템의 복구 요청을 읽습니다
koneksi organization-admin recovery reject
조직 관리자로서 시스템의 복구 요청을 거부합니다
복구 명령어
koneksi recovery request
새로운 복구 요청을 제출합니다.
koneksi recovery read
특정 복구 요청의 세부 정보를 검색합니다.
koneksi recovery list
제출된 모든 복구 요청을 나열합니다.
koneksi recovery delete
복구 요청을 취소하고 삭제합니다.
koneksi recovery process-queue
복구 대기열의 항목을 처리합니다.
koneksi recovery update-request
복구 요청의 매개변수를 업데이트합니다.
koneksi recovery update-request-status
복구 요청의 상태를 변경합니다.
koneksi recovery list-queue
현재 복구 대기열에 있는 모든 항목을 나열합니다.
koneksi recovery delete-queue-item
복구 대기열에서 특정 항목을 제거합니다.
koneksi recovery get-request-scope
복구 요청의 범위나 세부 정보를 검색합니다.
koneksi recovery start
관리자가 복구 요청을 승인한 후 복구를 시작합니다.
실시간 백업 명령어
koneksi realtime-backup directory stats
주어진 디렉토리의 파일 수와 총 저장소 크기를 표시합니다.
koneksi realtime-backup path read
현재 추적 중인 모든 호스트 디렉토리 경로를 나열합니다.
koneksi realtime-backup path remove
실시간 백업 추적에서 호스트 디렉토리 경로를 제거합니다.
koneksi realtime-backup queues read
대기 중이거나 진행 중인 실시간 백업 대기열 목록을 표시합니다.
koneksi realtime-backup queues delete
실시간 백업 대기열을 삭제합니다.
koneksi realtime-backup queues retry
대기열 항목 업로드를 다시 시도합니다.
koneksi realtime-backup realtime start
구성된 디렉토리에 대한 실시간 백업 프로세스를 시작합니다.
koneksi realtime-backup realtime sync
실시간 백업을 동기화합니다
koneksi realtime-backup watcher start
변경 사항을 모니터링하고 백업을 트리거하는 파일 시스템 감시자를 시작합니다.
koneksi realtime-backup watcher status
감시자의 현재 상태(실행 중 또는 중지됨)를 확인합니다.
koneksi realtime-backup watcher stop
활성 감시자 서비스를 중지합니다.
koneksi realtime-backup config create
실시간 백업 구성을 생성합니다.
koneksi realtime-backup config read
실시간 백업 구성을 읽습니다.
koneksi realtime-backup config sync
실시간 백업 구성을 동기화합니다.
복원 지점 명령어
koneksi restore-points create
스냅샷을 생성합니다
koneksi restore-points list
스냅샷을 나열합니다
koneksi restore-points read
스냅샷을 읽습니다
koneksi restore-points read-directory
스냅샷 디렉토리를 읽습니다
koneksi restore-points directory-scope
스냅샷 디렉토리 범위
koneksi restore-points file-scope
스냅샷 파일 범위
대시보드 명령어
koneksi dashboard metrics
저장소 사용량, 사용자 수, 파일 활동과 같은 전체 시스템 사용 메트릭을 표시합니다.
시스템 명령어
koneksi health
Koneksi API 서버의 운영 상태를 확인합니다. 자세한 진단을 위해 --verbose를 사용하세요.
도움말 명령어
koneksi help [command/category/category:command]
특정 명령어, 카테고리 또는 CLI 일반에 대한 자세한 도움말을 표시합니다.
일반 사용 예시
# 도움말 얻기
koneksi help
koneksi help auth login
# 명령을 제출할 때 사용할 기본 이메일을 설정합니다.
koneksi config set --email "your-email@example.com"
koneksi config show
koneksi config clear
# 새 사용자 등록
koneksi auth register --first-name "John" --last-name "Doe" --email "john.doe@example.com" --password "SecurePass123!" --confirm-password "SecurePass123!"
# 로그인 및 인증
koneksi auth login --email "john.doe@example.com" --password "SecurePass123!"
koneksi auth verify-otp --email "john.doe@example.com" --login-code "ABC123DEF456" --otp "123456"
koneksi auth interactive-reset
# 파일 관리
koneksi file upload --file-path "/path/to/file.png" --directory-id "682aa5a96ef58914bf648be7"
koneksi file download --file-id "682aa5a96ef58914bf648be8" --output-path "./downloaded-file.png"
koneksi file generate-link --file-id "682aa5a96ef58914bf648be8" --email "john.doe@example.com" --duration 48
koneksi file share --file-id "682aa5a96ef58914bf648be8" --email "john.doe@example.com" --share-email "friend@example.com" --access read
koneksi file move-multiple --email "email@example.com" --directory-id "68724f127d0d567ae10f58bd" --file-id "6872514c6d0ee8a367c7aa1d,6872514c6d0ee8a367c7aa1e"
koneksi file delete-multiple --email "email@example.com" --file-id "6872514c6d0ee8a367c7aa1d,6872514c6d0ee8a367c7aa1e"
koneksi file ipfs-upload --filename "file.txt" --file-location "/path/to/local/directory" --directory-id "68412ab66364bcf0c7848ed0" --replace-existing --environment "local"
# 디렉토리 관리
koneksi directory create --name "내 문서" --parent-id "682aa5a96ef58914bf648be7"
koneksi directory read --directory-id "682aa5a96ef58914bf648be7"
koneksi directory upload --email "john.doe@example.com" --path "/path/to/local/directory" --directory-id "682aa5a96ef58914bf648be7"
koneksi directory get-upload-queue --directory-id "682aa5a96ef58914bf648be7"
koneksi directory delete-upload-queue --queue-id "682aa5a96ef58914bf648be8"
koneksi directory retry-upload --queue-id "682aa5a96ef58914bf648be8"
koneksi directory get-subdirectories
koneksi directory move-multiple --email "email@example.com" --target-directory-id "68724f127d0d567ae10f58bd" --directory-ids "6872514c6d0ee8a367c7aa1d,6872514c6d0ee8a367c7aa1e"
koneksi directory delete-multiple --email "email@example.com" --directory-ids "6872514c6d0ee8a367c7aa1d,6872514c6d0ee8a367c7aa1e"
# 복구 관리
koneksi recovery request --email "email@example.com" --path "/recovery/path" --scope "full"
koneksi recovery read --email "email@example.com" --request-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery list --email "email@example.com" --page 1 --limit 10
koneksi recovery delete --email "email@example.com" --recovery-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery process-queue --email "email@example.com" --item-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery update-request --email "email@example.com" --recovery-id "6872514c6d0ee8a367c7aa1d" --path "/recovery/path" --scope "point_in_time" --start-date "2021-01-01T00:00:00Z" --end-date "2021-01-02T23:59:59Z"
koneksi recovery update-request-status --email "email@example.com" --recovery-id "6872514c6d0ee8a367c7aa1d" --status "in_progress"
koneksi recovery list-queue --email "email@example.com" --recovery-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery delete-queue-item --email "email@example.com" --item-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery get-request-scope --email "email@example.com" --recovery-id "6872514c6d0ee8a367c7aa1d"
koneksi recovery start --email "email@example.com" --request-id "6872514c6d0ee8a367c7aa1d"
# 실시간 백업 관리
koneksi realtime-backup directory stats --email "email@example.com" --path "/recovery/path"
koneksi realtime-backup path read --email "email@example.com"
koneksi realtime-backup path remove --email "email@example.com" --path "/path/to/directory"
koneksi realtime-backup queue read --email "email@example.com"
koneksi realtime-backup queues delete --email "email@example.com" --queue-id "6872514c6d0ee8a367c7aa1d"
koneksi realtime-backup queue retry-upload --email "email@example.com" --queue-id "6872514c6d0ee8a367c7aa1d"
koneksi realtime-backup realtime start --email "email@example.com"
koneksi realtime-backup realtime sync --email "email@example.com"
koneksi realtime-backup watcher start --email "email@example.com"
koneksi realtime-backup watcher status --email "email@example.com"
koneksi realtime-backup watcher stop --email "email@example.com"
koneksi realtime-backup config read --email "email@example.com"
koneksi realtime-backup config sync --email "email@example.com"
koneksi realtime-backup config create --email "email@example.com" --path "/path/to/directory"
# 복원 지점(스냅샷) 관리
koneksi restore-points create --description "테스트 설명"
koneksi restore-points list --page 1 --limit 10
koneksi restore-points read --snapshot-id "6872514c6d0ee8a367c7aa1d"
koneksi restore-points read-directory --snapshot-id "6872514c6d0ee8a367c7aa1d" --directory-id "6872514c6d0ee8a367c7aa1d" --display
koneksi restore-points directory-scope --snapshot-id "6872514c6d0ee8a367c7aa1d" --page 1 --limit 10
koneksi restore-points file-scope --snapshot-id "6872514c6d0ee8a367c7aa1d" --page 1 --limit 10
# 시스템 상태 확인
koneksi health --verbose
koneksi health --diagnostic
koneksi health --verbose --diagnostic공통 플래그
-e, --email
이메일 주소
-v, --verbose
상세 출력 표시
--help
명령에 대한 도움말 표시
Last updated