Documentation Index

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

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

createInitScript

Prev Next

VPC 환경에서 이용 가능합니다.

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

구문

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

./ncloud vserver createInitScript \
    --initScriptContent <init-script-content> \
    [--initScriptName <init-script-name>] \
    [--initScriptDescription <init-script-description>] \
    [--osTypeCode <LNX|WND>] \
    [--regionCode <KR|SGN|JPN>] \
    [--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 (VPC) 옵션을 참조해 주십시오.

예시

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

명령

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

./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 KR \
    --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"
  }
}