개요
공인 IP를 서버 인스턴스에 할당합니다.
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 | 
|---|---|---|---|---|
| publicIpInstanceNo | Yes | String | - 할당할 공인 IP 인스턴스 번호 publicIpInstanceNo는 getPublicIpInstanceList 액션을 통해 획득 가능  | 
|
| serverInstanceNo | Yes | String | - 할당할 서버 인스턴스 번호 공인 IP할당이 가능한 serverInstanceNo는 getPublicIpTargetServerInstanceList 액션을 통해 획득 가능  | 
|
| responseFormatType | No | String | - 응답 결과의 포맷 타입 Options : xml | json Default : xml  | 
응답
응답 바디
예시
요청 예시
GET {SERVER_API_URL}/associatePublicIpWithServerInstance
?publicIpInstanceNo=1089236
&serverInstanceNo=1088217
응답 예시
<associatePublicIpWithServerInstanceResponse>
  <requestId>b4b38b18-a07e-4b9b-84fb-1ffeda6638fd</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>1089236</publicIpInstanceNo>
      <publicIp>49.236.137.138</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2018-11-28T14:38:55+0900</createDate>
      <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>USE</code>
        <codeName>NET USE OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp>
        <serverInstanceNo>1088217</serverInstanceNo>
        <serverName>s167545541a3</serverName>
        <serverDescription></serverDescription>
        <cpuCount>4</cpuCount>
        <memorySize>8589934592</memorySize>
        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
        <platformType>
          <code>LNX32</code>
          <codeName>Linux 32 Bit</codeName>
        </platformType>
        <loginKeyName>juhoon-kim</loginKeyName>
        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
        <publicIp>49.236.137.138</publicIp>
        <privateIp>10.41.83.168</privateIp>
        <serverImageName>centos-6.3-32</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-11-27T17:42:13+0900</createDate>
        <uptime>2018-11-27T18:35:47+0900</uptime>
        <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
        <serverProductCode>SPSVRSTAND000005</serverProductCode>
        <isProtectServerTermination>false</isProtectServerTermination>
        <portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
        <zone>
          <zoneNo>3</zoneNo>
          <zoneName>KR-2</zoneName>
          <zoneCode>KR-2</zoneCode>
          <zoneDescription>평촌 zone</zoneDescription>
          <regionNo>1</regionNo>
        </zone>
        <region>
          <regionNo>1</regionNo>
          <regionCode>KR</regionCode>
          <regionName>Korea</regionName>
        </region>
        <baseBlockStorageDiskType>
          <code>NET</code>
          <codeName>Network Storage</codeName>
        </baseBlockStorageDiskType>
        <baseBlockStorageDiskDetailType>
          <code>HDD</code>
          <codeName>HDD</codeName>
        </baseBlockStorageDiskDetailType>
        <serverInstanceType>
          <code>STAND</code>
          <codeName>Standard</codeName>
        </serverInstanceType>
        <userData></userData>
        <accessControlGroupList>
          <accessControlGroup>
            <accessControlGroupConfigurationNo>39995</accessControlGroupConfigurationNo>
            <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
            <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
            <isDefault>true</isDefault>
            <createDate>2018-04-09T11:12:54+0900</createDate>
          </accessControlGroup>
        </accessControlGroupList>
        <instanceTagList/>
      </serverInstanceAssociatedWithPublicIp>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>평촌 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</associatePublicIpWithServerInstanceResponse>
에러 코드
아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요
| HTTP Response Code | 리턴 코드 | 리턴 메시지 | 
|---|---|---|
| 400 | 24094 | The line for internet access of server does not correspond with which of Public IP. | 
| 400 | 24109 | The input parameter instance number is invalid | 
| 400 | 24120 | The input parameter server instance number is invalid. | 
| 400 | 24122 | The input parameter public IP instance number is invalid. | 
| 400 | 25029 | You may not perform the allocate task since (other) user is changing the target official IP settings. | 
| 400 | 25101 | The server is currently being operated. so public IP is unable to be associated with the server. | 
| 400 | 28100 | Another public IP is already associated with the server. | 
| 400 | 28101 | A public IP is already associated with server. |