createPublicIpInstance

Prev Next

개요

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

요청

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
serverInstanceNo No String - 공인 IP를 생성 후 할당할 서버 인스턴스 번호
공인 IP를 할당 가능한 serverInstanceNo는 getPublicIpTargetServerInstanceList 액션을 통해 획득 가능
publicIpDescription No String Min : 1, Max : 1000 공인 IP 설명
regionNo No String - 리전 번호
공인 IP가 생설될 regionNo는 getRegionList 액션을 통해 획득 가능
zoneNo No String - ZONE번호
공인 IP가 생성될 zoneNo는 getZoneList 액션을 통해 획득 가능
Default : 해당리전의 첫번째 ZONE을 선택
responseFormatType No String - 응답 결과의 포맷 타입
Options : xml | json
Default : xml

응답

응답 바디

예시

요청 예시

GET {SERVER_API_URL}/createPublicIpInstance

응답 예시

<createPublicIpInstanceResponse>
  <requestId>2f8ca49e-0532-43f2-884d-d7f8a737cac4</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>created</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>NULL</code>
        <codeName>NET NULL OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp/>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>평촌 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>

에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

HTTP Response Code 리턴 코드 리턴 메시지
400 10101 Unable to request for public IP. You may request as many public IPs as the number of server in possession.
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 24094 The line for internet access of server does not correspond with which of Public IP.
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.