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.

recreateServerInstance

Prev Next

概要

サーバインスタンス再作成

説明

サーバインスタンスを再作成します。(ベアメタル専用)

リクエストパラメータ

パラメータ名 必須 タイプ 制約事項 説明
serverInstanceNo Yes String Repeat not allowed 再作成するインスタンス番号
serverInstanceName No String 再作成する時、変更する名称
Default : もとのサーバ名で作成
serverImageProductCode Yes String サーバイメージ商品リスト照会(getServerImageProductList) APIを通じて取得できます。
ベアメタルサーバイメージのみ入力できます。
userData No String Min: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.tagKey No String 作成するインスタンスタグリスト、タグキー
instanceTagList.tagValue No String 作成するインスタンスタグリスト、タグ値
isVaccineInstall No Boolean アンチウィルスソフトウェア設置有無を設定できます。 (ベアメタルウィンドウズサーバ限定) 基本値は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;
private List blockDevicePartitionList;

例示

呼び出し

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>