Documentation Index

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

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

createLaunchConfiguration

Prev Next

개요

론치 설정 생성

설명

론치 설정은 오토 스케일링이 클라우드 서버 인스턴스를 생성하여 서비스에 투입하기 위해 사용되는 템플릿(template)입니다.
그 템플릿은 오토 스케일링이 서버 인스턴스를 생성하기 위한 모든 정보를 포함하고 있습니다. 론치 설정 속성은 한 번 생성되면 이후 변경이 안됩니다.

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
launchConfigurationName No String Min : 1, Max : 255 론치 설정의 이름으로 식별자 역할을 함
Default: Ncloud에서 알아서 배정
serverImageProductCode Conditional String Min : 1, Max : 20 - 서버 이미지에 설치된 SW(OS 포함)의 상품 코드
소프트웨어 상품 코드(serverImageProductCode) 또는 회원 서버 이미지 번호(memberServerImageNo와) 둘 중 하나는 필수값으로 둘 중 하나는 지정되어 있어야 함
그러나 둘 다 지정되어서는 안됨
serverProductCode No String Min : 1, Max : 20 - 서버 HW spec과 관련된 서버 상품 코드
Default : 최소 사양으로 만들어짐
memberServerImageNo Conditional String - - 회원이 직접 만든 내 서버 이미지 번호
소프트웨어 상품 코드(serverImageProductCode) 또는 회원 서버 이미지 번호(memberServerImageNo와) 둘 중 하나는 필수값으로 지정되어 있어야 함
그러나 둘 다 지정되어서는 안됨
accessControlGroupConfigurationNoList No List 중복불가 Access Control Group(ACG) 설정 번호로 지정하지 않으면 기본 Access Control Group(ACG)가 지정됨
loginKeyName No String Min : 3, Max : 30 - 로그인 키 이름
지정되어 있지 않으면 사용자가 최근에 만든 로그인 키 이름이 지정됨
Default: 가장 최근에 만든 로그인키 명 사용
userData No String Min : 1
Max : 21847
사용자데이터로 BASE64 encoding 문자열만 허용
서버 인스턴스가 첫 부팅을 할 때, BASE64 encoding된 문자열을 decoding하여 평문이 된 문자열로 구성된 스크립트 파일이 실행됨
사용자데이터(userData)와 초기화스크립트번호(initScriptNo) 두 개의 파라미터를 같이 전달하면 생성 오류 처리됨
initScriptNo No String - 초기화스크립트 번호
서버가 최초 부팅시 사용자가 설정한 초기화 스크립트를 실행
초기화 스크립트의 초기화스크립트번호를 매개변수로 전달함
사용자데이터(userData)와 초기화스크립트번호(initScriptNo) 두 개의 파라미터를 같이 전달하면 생성 오류 처리됨
initScriptNo는 getInitScriptList 액션을 통해 얻을 수 있음
regionNo No String 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능

응답 데이터 타입

  • LaunchConfigurationList 타입
LaunchConfigurationList extends CommonResponse
private Integer totalRows;
private List launchConfigurationList = new ArrayList();
LaunchConfiguration extends BaseObject
private String launchConfigurationName;
private String launchConfigurationNo;
private String serverImageProductCode;
private String serverProductCode;
private String memberServerImageNo;
private String loginKeyName;
private Date createDate;
private String userData;
private String initScriptNo;
private List accessControlGroupList;
AccessControlGroup extends BaseObject
private String accessControlGroupConfigurationNo;
private String accessControlGroupName;
private String accessControlGroupDescription;
private boolean isDefault;
private Date createDate;

예시

호출

ncloud autoscaling createLaunchConfiguration --serverImageProductCode SPSW0LINUX000046 --launchConfigurationName test-autoscaling

응답

{
  "createLaunchConfigurationResponse": {
    "requestId": "9de32408-bb3d-4c68-bc42-aa5a3e7f4612",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "launchConfigurationName": "test-autoscaling",
        "launchConfigurationNo": "***013",
        "serverImageProductCode": "SPSW0LINUX000046",
        "serverProductCode": "SPSVRSTAND000003",
        "memberServerImageNo": "",
        "loginKeyName": "packer-1522153936",
        "createDate": "2018-04-05T14:53:16+0900",
        "userData": "",
        "initScriptNo": ""
      }
    ]
  }
}
<?xml version="1.0" encoding="UTF-8" ?>
<createLaunchConfigurationResponse>
  <requestId>9de32408-bb3d-4c68-bc42-aa5a3e7f4612</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <launchConfigurationList>
    <launchConfigurationName>test-autoscaling</launchConfigurationName>
    <launchConfigurationNo>***013</launchConfigurationNo>
    <serverImageProductCode>SPSW0LINUX000046</serverImageProductCode>
    <serverProductCode>SPSVRSTAND000003</serverProductCode>
    <memberServerImageNo></memberServerImageNo>
    <loginKeyName>packer-1522153936</loginKeyName>
    <createDate>2018-04-05T14:53:16+0900</createDate>
    <userData></userData>
    <initScriptNo></initScriptNo>
  </launchConfigurationList>
</createLaunchConfigurationResponse>