createAutoScalingGroup
    • PDF

    createAutoScalingGroup

    • PDF

    기사 요약

    개요

    오토스케일링 그룹 생성

    설명

    식별자 역할을 하는 이름과 여타 속성을 지정해서 새로운 오토 스케일링 그룹을 생성합니다.
    생성 요청이 완료되면 오토 스케일링 그룹은 다른 호출에서 사용될 완성된 상태가 되어 있습니다.
    단, 생성 요청이 완료 되었다고 그룹 소속의 서버 인스턴스들이 생성이 완료되어 서비스에 투입이 완료됨을 보장하지는 않습니다.

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    autoScalingGroupNameNoStringMin : 1, Max : 255- 오토 스케일링 그룹명
    그룹 식별자 역할을 하며 한번 정해지면 그 뒤로는 불변
    launchConfigurationNameYesStringMin : 1, Max : 255- 론치 설정 명
    해당 오토 스케일링 그룹 소속의 서버 인스턴스가 새로 생성될 때 사용되는 서버 관련 정보를 담고 있음
    desiredCapacityNoIntegerMin : 0, Max : 30- 기대 서비스 능력
    해당 그룹 소속으로 운영될 서버 인스턴스들의 수를 설정함
    이 값이 오토스케일링에 이미 세팅되어 있는 기존 속성인 min size보다 작아서는 안되고 max size보다 커서는 안됨
    minSizeYesIntegerMin : 0, Max : 30- 최소 사이즈(최소 0이고 maxSize 값보다 작거나 같아야 함)
    Min : 최소 사이즈(minSize), Max : 최대 사이즈(maxSize)
    Min : 0, Max : 30
    maxSizeYesIntegerMin : 0, Max : 30최대 사이즈(최소 0, 최대 30)
    defaultCooldownNoIntegerMin : 0, Max : 2147483647- 디폴트 cooldown 시간
    Default : 300초로 세팅됨
    loadBalancerNameListNoListMin : 3, Max : 30(중복불가)해당 그룹 소속 서버가 생성되어 서비스에 투입될 때 등록될 로드밸런서 이름 리스트
    healthCheckGracePeriodConditionalIntegerMin : 0, Max : 2147483647- health check 보류 기간
    서버 인스턴스가 서비스에 투입된 이후 health check를 보류할 시간을 설정함
    healthCheckTypeCode 값이 로드밸런서(LOADB)이면 필수
    healthCheckTypeCodeNoStringMin : 1, Max : 5- Health check 유형 코드
    현재 사용 가능한 유형(type) 코드로는 서버(SVR)과 로드밸런서(LOADB)가 있음
    zoneNoListYesString중복불가- Zone 번호 리스트
    이 그룹 소속 서버 인스턴스들이 존재할 zone 번호 리스트를 넣음
    예시) zone code: 2 , zone name: KR-1/ zone code: 3 , zone name: KR-2

    응답 데이터 타입

    • AutoScalingGroupList 타입
    AutoScalingGroupList extends CommonResponse
    private Integer totalRows;
    private List autoScalingGroupList = new ArrayList();
    AutoScalingGroup extends BaseObject
    private String autoScalingGroupName;
    private String autoScalingGroupNo;
    private String launchConfigurationName;
    private String launchConfigurationNo;
    private Integer desiredCapacity;
    private Integer minSize;
    private Integer maxSize;
    private Integer defaultCooldown;
    private List loadBalancerInstanceSummaryList;
    private Integer healthCheckGracePeriod;
    private CommonCode healthCheckType;
    private Date createDate;
    private List inAutoScalingGroupServerInstanceList;
    private List suspendedProcessList;
    private List zoneList;
    LoadBalancerInstanceSummary extends BaseObject
    private String loadBalancerInstanceNo;
    private String loadBalancerName;
    InAutoScalingGroupServerInstance extends BaseObject
    private CommonCode healthStatus;
    private CommonCode lifecycleState;
    private LaunchConfiguration launchConfiguration;
    private String serverInstanceNo;
    private String serverInstanceName;
    SuspendedProcess
    private CommonCode process;
    private String suspensionReason;
    Zone
    private String zoneNo;
    private String zoneName;
    private String zoneCode;
    private String zoneDescription;
    private String regionNo;
    private long totalMemorySize;
    private long totalUsedMemorySize;
    private long totalUsePossibleMemorySize;
    CommonCode
    private String codeKind;
    private String detailCategorizeCode;
    private String code;
    private String codeName;
    private Integer codeOrder;
    private String javaConstantCode;
    LaunchConfiguration
    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 List accessControlGroupList;
    AccessControlGroup extends BaseObject
    private String accessControlGroupConfigurationNo;
    private String accessControlGroupName;
    private String accessControlGroupDescription;
    private boolean isDefault;
    private Date createDate;

    예시

    호출

    ncloud autoscaling createAutoScalingGroup --autoScalingGroupName test-autoscaling-group --launchConfigurationName test-autoscailg-launch --minSize 0 --maxSize 1 --zoneNoList 2
    

    응답

    {
      "createAutoScalingGroupResponse": {
        "requestId": "08c6d98c-1b6e-4c52-9099-4d32555b34aa",
        "returnCode": "0",
        "returnMessage": "success",
        "totalRows": 1,
        "autoScalingGroupList": [
          {
            "autoScalingGroupName": "test-autoscaling-group",
            "autoScalingGroupNo": "***517",
            "launchConfigurationName": "test-autoscailg-launch",
            "launchConfigurationNo": "***013",
            "desiredCapacity": 0,
            "minSize": 0,
            "maxSize": 1,
            "defaultCooldown": 300,
            "loadBalancerInstanceSummaryList": [],
            "healthCheckGracePeriod": 300,
            "healthCheckType": {
              "code": "SVR",
              "codeName": "Server"
            },
            "createDate": "2018-04-05T20:43:57+0900",
            "inAutoScalingGroupServerInstanceList": [],
            "suspendedProcessList": [],
            "zoneList": [
              {
                "zoneNo": "2",
                "zoneName": "KR-1",
                "zoneCode": "KR-1",
                "zoneDescription": "KR-1 zone",
                "regionNo" : "1"
              }
            ]
          }
        ]
      }
    }
    
    <?xml version="1.0" encoding="UTF-8" ?>
    <createAutoScalingGroupResponse>
      <requestId>08c6d98c-1b6e-4c52-9099-4d32555b34aa</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <autoScalingGroupList>
        <autoScalingGroupName>test-autoscaling-group</autoScalingGroupName>
        <autoScalingGroupNo>***517</autoScalingGroupNo>
        <launchConfigurationName>test-autoscailg-launch</launchConfigurationName>
        <launchConfigurationNo>***013</launchConfigurationNo>
        <desiredCapacity>0</desiredCapacity>
        <minSize>0</minSize>
        <maxSize>1</maxSize>
        <defaultCooldown>300</defaultCooldown>
        <loadBalancerInstanceSummaryList/>
        <healthCheckGracePeriod>300</healthCheckGracePeriod>
        <healthCheckType>
          <code>SVR</code>
          <codeName>Server</codeName>
        </healthCheckType>
        <createDate>2018-04-05T20:43:57+0900</createDate>
        <inAutoScalingGroupServerInstanceList/>
        <suspendedProcessList/>
        <zoneList>
          <zoneNo>2</zoneNo>
          <zoneName>KR-1</zoneName>
          <zoneCode>KR-1</zoneCode>
          <zoneDescription>KR-1 zone</zoneDescription>
          <regionNo>1</regionNo>
        </zoneList>
      </autoScalingGroupList>
    </createAutoScalingGroupResponse>
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.