recreateServerInstance
    • PDF

    recreateServerInstance

    • PDF

    기사 요약

    개요

    서버 인스턴스 재생성

    설명

    서버 인스턴스를 재생성합니다.(베어메탈 전용)

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    serverInstanceNoYesStringRepeat not allowed재생성할 인스턴스 번호
    serverInstanceNameNoString재생성시 변경할 이름 (Default : 원래 서버 이름으로 생성)
    serverImageProductCodeYesString서버 이미지 상품 리스트 조회(getServerImageProductList) API를 통해 획득 가능
    베어메탈 서버 이미지만 입력 가능
    userDataNoStringMin:1, Max:21847서버가 최초 부팅 시 사용자가 설정한 사용자 데이타 스크립트를 수행시켜 줌
    해당 컬럼을 조회하기 위해서는 getServerInstanceList 액션을 통해 특정 인스턴스 조회 시에만 반환됨
    userData값을 넣기 전에 base64 Encoding, URL Encoding이 반드시 필요함
    base64로 Encoding된 결과를 다시 URL Encoding을 하지 않으면 signature invalid 에러 발생
    스크립트 문자열을 직접 수행시키는 것 외에 스크립트가 저장된 파일 경로를 매개 변수로 받을 수도 있음
    ex) file://directory1/directory2/*.sh
    ex) https://{OBJECT_STORAGE_URL}/.sh
    instanceTagList.tagKeyNoString생성할 인스턴스 태그 리스트 (태그 키)
    instanceTagList.tagValueNoString생성할 인스턴스 태그 리스트 (태그 값)
    isVaccineInstallNoBoolean백신설치유무 설정 가능 (베어메탈 윈도우서버 한정)
    기본값은 true

    응답 데이터 타입

    • ServerInstanceList type
    ServerInstanceList extends CommonResponse
    private Integer totalRows;
    private List serverInstanceList = new ArrayList();
    ServerInstance
    private String serverInstanceNo;
    private String serverName;
    private String serverDescription;
    private Integer cpuCount;
    private Long memorySize;
    private Long baseBlockStorageSize;
    private CommonCode platformType;
    private String loginKeyName;
    private Boolean isFeeChargingMonitoring;
    private String publicIp;
    private String privateIp;
    private String serverImageName;
    private CommonCode serverInstanceStatus;
    private CommonCode serverInstanceOperation;
    private String serverInstanceStatusName;
    private Date createDate;
    private Date uptime;
    private String serverImageProductCode;
    private String serverProductCode;
    private Boolean isProtectServerTermination;
    private String portForwardingPublicIp;
    private Integer portForwardingExternalPort;
    private Integer portForwardingInternalPort;
    private Zone zone;
    private Region region;
    private CommonCode baseBlockStorageDiskType;
    private CommonCode baseBlockStorageDiskDetailType;
    private CommonCode serverInstanceType
    private String userData;
    private String initScriptNo;
    private List accessControlGroupList;
    private List instanceTagList;

    예시

    호출

    ncloud server recreateServerInstance --serverInstanceNo 680744 --serverImageProductCode SPSWBMWINNT00001
    

    응답

    {
      "recreateServerInstancesResponse": {
        "requestId": "4edb4864-24b0-4ffc-80ee-9d0badc5f124",
        "returnCode": "0",
        "returnMessage": "success",
        "totalRows": 1,
        "serverInstanceList": [
          {
            "serverInstanceNo": "397364",
            "serverName": "ncloud-mktest3",
            "serverDescription": "",
            "cpuCount": 1,
            "memorySize": 2147483648,
            "baseBlockStorageSize": 53687091200,
            "platformType": {
              "code": "LNX64",
              "codeName": "Linux 64 Bit"
            },
            "loginKeyName": "ysw",
            "isFeeChargingMonitoring": false,
            "publicIp": "",
            "privateIp": "10.113.245.164",
            "serverImageName": "centos-7.3-64",
            "serverInstanceStatus": {
              "code": "RUN",
              "codeName": "Server RUN State"
            },
            "serverInstanceOperation": {
              "code": "RESTA",
              "codeName": "Server RESTART OP"
            },
            "serverInstanceStatusName": "rebooting",
            "createDate": "2018-02-23T15:44:59+0900",
            "uptime": "2018-02-23T15:55:55+0900",
            "serverImageProductCode": "SPSW0LINUX000046",
            "serverProductCode": "SPSVRSTAND000003",
            "isProtectServerTermination": false,
            "portForwardingPublicIp": "192.168.120.111",
            "zone": {
              "zoneNo": "2",
              "zoneName": "KR-1",
              "zoneDescription": "KR-1 zone"
            },
            "region": {
              "regionNo": "1",
              "regionCode": "KR",
              "regionName": "Korea"
            },
            "baseBlockStorageDiskType": {
              "code": "NET",
              "codeName": "Network Storage"
            },
            "baseBlockStroageDiskDetailType": {
              "code": "HDD",
              "codeName": "HDD"
            },
            "serverInstanceType": {
              "code": "STAND"
              "codeName": "Standard"
            },
            "userData": "",
            "initScriptNo": "",
            "accessControlGroupList": [
              {
                "accessControlGroupConfigurationNo": "1038",
                "accessControlGroupName": "ncloud-default-acg",
                "accessControlGroupDescription": "Default AccessControlGroup",
                "isDefault": true,
                "createDate": "2013-12-03T10:37:39+0900"
              }
            ]
          }
        ]
      }
    }
    
    <?xml version="1.0" encoding="UTF-8" ?>
    <recreateServerInstancesResponse>
      <requestId>4edb4864-24b0-4ffc-80ee-9d0badc5f124</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstanceNo>397364</serverInstanceNo>
        <serverName>ncloud-mktest3</serverName>
        <serverDescription></serverDescription>
        <cpuCount>1</cpuCount>
        <memorySize>2147483648</memorySize>
        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
        <platformType>
          <code>LNX64</code>
          <codeName>Linux 64 Bit</codeName>
        </platformType>
        <loginKeyName>ysw</loginKeyName>
        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
        <publicIp></publicIp>
        <privateIp>10.113.245.164</privateIp>
        <serverImageName>centos-7.3-64</serverImageName>
        <serverInstanceStatus>
          <code>RUN</code>
          <codeName>Server RUN State</codeName>
        </serverInstanceStatus>
        <serverInstanceOperation>
          <code>RESTA</code>
          <codeName>Server RESTART OP</codeName>
        </serverInstanceOperation>
        <serverInstanceStatusName>rebooting</serverInstanceStatusName>
        <createDate>2018-02-23T15:44:59+0900</createDate>
        <uptime>2018-02-23T15:55:55+0900</uptime>
        <serverImageProductCode>SPSW0LINUX000046</serverImageProductCode>
        <serverProductCode>SPSVRSTAND000003</serverProductCode>
        <isProtectServerTermination>false</isProtectServerTermination>
        <portForwardingPublicIp>192.168.120.111</portForwardingPublicIp>
        <zone>
          <zoneNo>2</zoneNo>
          <zoneName>KR-1</zoneName>
          <zoneDescription>KR-1 zone</zoneDescription>
        </zone>
        <region>
          <regionNo>1</regionNo>
          <regionCode>KR</regionCode>
          <regionName>Korea</regionName>
        </region>
        <baseBlockStorageDiskType>
          <code>NET</code>
          <codeName>Network Storage</codeName>
        </baseBlockStorageDiskType>
        <baseBlockStroageDiskDetailType>
          <code>HDD</code>
          <codeName>HDD</codeName>
        </baseBlockStroageDiskDetailType>
        <serverInstanceType>
          <code>STAND</code>
          <codeName>Standard</codeName>
        </serverInstanceType>
        <userData></userData>
        <initScriptNo></initScriptNo>
        <accessControlGroupList>
          <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
          <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
          <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
          <isDefault>true</isDefault>
          <createDate>2013-12-03T10:37:39+0900</createDate>
        </accessControlGroupList>
      </serverInstanceList>
    </recreateServerInstancesResponse>
    

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

    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.