Documentation Index

Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

importLoginKey

Prev Next

사용자가 ssh-keygen으로 직접 생성한 공개키(Public Key)를 사용하여 인증키(Login Key)를 생성합니다.

구문

importLoginKey 구문은 다음과 같습니다.

./ncloud vserver importLoginKey \
    --publicKey <public-key> \
    [--keyName <key-name>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

importLoginKey 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

importLoginKey의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--publicKey String Required 공개키
  • ssh-keygen -t rsa -C "key-name" -f ~/.ssh/key-name으로 생성한 공개키
  • ssh-keygen 버전에 따라 -b 2048 -m PEM 옵션 필요

선택 옵션

importLoginKey의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--keyName String Optional 인증키 이름
  • 미입력 시 자동 생성
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~30자 이내로 입력
  • 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성

공통 옵션

vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server 옵션을 참조해 주십시오.

예시

인증키 불러오기 요청이 성공하면 등록된 인증키의 이름과 생성 일시가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vserver importLoginKey \
    --publicKey "ssh-rsa AAAAB3Nz...test-import-key-01" \
    --keyName test-import-key-01 \
    --regionCode FKR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "importLoginKeyResponse": {
    "loginKeyList": [
      {
        "fingerprint": "",
        "keyName": "test-import-key-01",
        "createDate": "2026-05-18T17:13:20+0900"
      }
    ],
    "requestId": "e401a9fc-61ff-49f2-bde9-bf8aaefc7e39",
    "returnCode": "0",
    "returnMessage": "success"
  }
}