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>