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.

createInitScript

Prev Next

초기화 스크립트(Init Script)를 생성합니다. 초기화 스크립트는 미리 작성해 둔 스크립트를 서버 생성 시 자동으로 실행시킬 수 있는 기능으로, 같은 용도의 서버를 일괄 생성하거나 주기적으로 생성할 수 있습니다.

구문

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

./ncloud vserver createInitScript \
    --initScriptContent <init-script-content> \
    [--initScriptName <init-script-name>] \
    [--initScriptDescription <init-script-description>] \
    [--osTypeCode <LNX|WND>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createInitScript의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--initScriptContent String Required 초기화 스크립트 내용 (KB)
  • 0~1024
  • 영문만 입력 가능
  • Linux: Python, Perl, Shell 등의 스크립트 사용 가능
    • 첫 줄에 스크립트 경로 지정 필요 (예시: #!/usr/bin/env python, #!/usr/bin/perl, #!/bin/bash)
  • Windows: Visual Basic 스크립트 사용 가능

선택 옵션

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

옵션 타입 필수 여부 설명
--initScriptName String Optional 초기화 스크립트 이름
  • 미입력 시 자동 생성
  • 영문자, 숫자, 특수문자 -를 조합하여 3~30자 이내로 입력
  • 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성
--initScriptDescription String Optional 초기화 스크립트 설명 (Byte)
  • 0~1000
--osTypeCode String Optional 운영체제 타입 코드
  • LNX (기본값) | WND
    • LNX: Linux
    • WND: Windows

공통 옵션

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

예시

초기화 스크립트 생성 요청이 성공하면 생성된 스크립트의 상세 정보가 반환됩니다.

명령

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

./ncloud vserver createInitScript \
    --initScriptContent "#!/bin/bash
echo \"Hello from init script\"
sudo apt-get update -y" \
    --initScriptName test-init-script-01 \
    --initScriptDescription "Test init script for documentation" \
    --osTypeCode LNX \
    --regionCode FKR \
    --output json

출력

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

{
  "createInitScriptResponse": {
    "totalRows": 1,
    "initScriptList": [
      {
        "initScriptNo": "12345678",
        "initScriptName": "test-init-script-01",
        "createDate": "2026-05-14T14:08:35+0900",
        "initScriptDescription": "Test init script for documentation",
        "initScriptContent": "#!/bin/bash\necho \"Hello from init script\"\nsudo apt-get update -y",
        "osType": {
          "code": "LNX",
          "codeName": "LINUX"
        }
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}