createPublicIpInstance

Prev Next

개요

공인 IP 인스턴스 생성

설명

공인 IP 인스턴스를 생성합니다.

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
serverInstanceNo No String - 공인 IP를 생성 후 할당할 서버 인스턴스 번호
getPublicIpTargetServerInstanceList 액션을 통해 획득 가능
publicIpDescription No String Min : 10, Max : 1000 공인IP 설명
regionNo No String - 리전번호
입력 가능한 상태는 getRegionList 액션을 통해 획득 가능
zoneNo No String - ZONE번호
공인 IP가 생성될 ZONE 결정 가능
Default : 해당리전의 첫번째 ZONE을 선택

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;
private ServerInstance serverInstanceAssociatedWithPublicIp;
private Region region;
private Zone zone;

예시

호출

ncloud server createPublicIpInstance --serverInstanceNo 397255

응답

{
  "createPublicIpInstanceResponse": {
    "requestId": "a2719e72-1709-48ac-acfe-d0d9197431e3",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "publicIpInstanceList": [
      {
        "publicIpInstanceNo": "397266",
        "publicIp": "192.168.60.126",
        "publicIpDescription": "",
        "createDate": "2018-02-23T14:10:01+0900",
        "publicIpInstanceStatusName": "using",
        "publicIpInstanceStatus": {
          "code": "CREAT",
          "codeName": "NET CREAT State"
        },
        "publicIpInstanceOperation": {
          "code": "USE",
          "codeName": "NET USE OP"
        },
        "publicIpKindType": {
          "code": "GEN",
          "codeName": "General"
        },
        "serverInstanceAssociatedWithPublicIp": {
          "serverInstanceNo": "397255",
          "serverName": "ncloud-mktest",
          "serverDescription": "",
          "cpuCount": 1,
          "memorySize": 2147483648,
          "baseBlockStorageSize": 53687091200,
          "platformType": {
            "code": "LNX64",
            "codeName": "Linux 64 Bit"
          },
          "loginKeyName": "ysw",
          "isFeeChargingMonitoring": false,
          "publicIp": "192.168.60.126",
          "privateIp": "10.113.245.112",
          "serverImageName": "centos-7.3-64",
          "serverInstanceStatus": {
            "code": "RUN",
            "codeName": "Server RUN State"
          },
          "serverInstanceOperation": {
            "code": "NULL",
            "codeName": "Server NULL OP"
          },
          "serverInstanceStatusName": "running",
          "createDate": "2018-02-23T13:55:34+0900",
          "uptime": "2018-02-23T13:58:34+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"
          },
          "userData": "",
          "accessControlGroupList": [
            {
              "accessControlGroupConfigurationNo": "1038",
              "accessControlGroupName": "ncloud-default-acg",
              "accessControlGroupDescription": "Default AccessControlGroup",
              "isDefault": true,
              "createDate": "2013-12-03T10:37:39+0900"
            }
          ],
          "instanceTagList" : [],
        },
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo" : "1"
        }
      }
    ]
  }
}
<?xml version="1.0" encoding="UTF-8" ?>
<createPublicIpInstanceResponse>
  <requestId>a2719e72-1709-48ac-acfe-d0d9197431e3</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstanceNo>397266</publicIpInstanceNo>
    <publicIp>192.168.60.126</publicIp>
    <publicIpDescription></publicIpDescription>
    <createDate>2018-02-23T14:10:01+0900</createDate>
    <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
    <publicIpInstanceStatus>
      <code>CREAT</code>
      <codeName>NET CREAT State</codeName>
    </publicIpInstanceStatus>
    <publicIpInstanceOperation>
      <code>USE</code>
      <codeName>NET USE OP</codeName>
    </publicIpInstanceOperation>
    <publicIpKindType>
      <code>GEN</code>
      <codeName>General</codeName>
    </publicIpKindType>
    <serverInstanceAssociatedWithPublicIp>
      <serverInstanceNo>397255</serverInstanceNo>
      <serverName>ncloud-mktest</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>192.168.60.126</publicIp>
      <privateIp>10.113.245.112</privateIp>
      <serverImageName>centos-7.3-64</serverImageName>
      <serverInstanceStatus>
        <code>RUN</code>
        <codeName>Server RUN State</codeName>
      </serverInstanceStatus>
      <serverInstanceOperation>
        <code>NULL</code>
        <codeName>Server NULL OP</codeName>
      </serverInstanceOperation>
      <serverInstanceStatusName>running</serverInstanceStatusName>
      <createDate>2018-02-23T13:55:34+0900</createDate>
      <uptime>2018-02-23T13:58:34+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>
      <userData></userData>
      <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>
      <instanceTagList/>
    </serverInstanceAssociatedWithPublicIp>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>