MENU
      getPublicIpInstanceList

        getPublicIpInstanceList


        기사 요약

        개요

        공인 IP 인스턴스 리스트를 조회합니다.

        요청

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        isAssociatedNoBoolean- 할당 여부
        할당된 공인 IP, 할당되지 않은 공인 IP 조회 가능
        Options : true | false
        publicIpInstanceNoList.NNoString중복 불가- 조회할 공인 IP 인스턴스 번호 리스트
        ex) publicIpInstanceNoList.1=937520&publicIpInstanceNoList.2=932956
        publicIpList.NNoList<String>Min : 5, Max : 15- 조회할 공인 IP 리스트
        ex) publicIpList.1=106.10.53.67
        searchFilterNameNoString- 검색할 필터명
        공인 IP(publicIp)와 할당된 서버명(associatedServerName)으로 필터링하여 검색
        Options : publicIp | associatedServerName [대소문자 구분 없음]
        searchFilterName은 아래의 searchFilterValue 값과 mapping하여 사용
        ex) searchFilterName=publicIp&searchFilterValue=106.10.53.67
        ex) searchFilterName=associatedServerName&searchFilterValue=s1669aa4e78c
        searchFilterValueNoString- 검색할 필터값
        위의 searchFilterName 값과 mapping할 값 입력
        regionNoNoString- 리전 번호
        공인 IP 인스턴스 리스트를 리전(Region)을 이용하여 필터링 가능
        regionNo는 getRegionList 액션을 통해 획득 가능
        zoneNoNoString- ZONE번호
        공인 IP 인스턴스 리스트를 존(zone)을 이용하여 필터링 가능
        zoneNo는 getZoneList 액션을 통해 획득 가능
        필터를 설정하지 않으면 해당 리전(Region)의 존(zone)에 속한 공인 IP 리스트가 모두 선택됨
        pageNoNoIntegerMin : 0,
        Max : 2147483647
        - 페이징된 결과의 페이지 번호
        결과값을 pageNo를 이용하여 페이징 처리 가능
        pageSizeNoIntegerMin : 0,
        Max : 2147483647
        - 페이징 시 보여줄 각 페이지 사이즈
        결과값을 pageSize를 이용하여 페이징 처리 가능
        sortedByNoString- 정렬 대상
        공인 IP와 공인 IP 인스턴스 번호로 정렬
        Options : publicIp (공인 IP) | publicIpInstanceNo (공인 IP 인스턴스 번호) [대소문자 구분 없음]
        Default : publicIpInstanceNo
        sortedBy는 아래의 sortingOrder와 mapping하여 사용
        ex) sortedBy=publicIp&sortingOrder=ascending
        ex) sortedBy=publicIpInstanceNo&sortingOrder=descending
        sortingOrderNoString- 정렬 순서
        위에서 설정한 SortedBy의 오름차순/내림차순 정렬 설정
        ascending (오름차순) | descending (내림차순) [대소문자 구분 없음]
        default : ascending

        응답

        응답 바디

        예시

        요청 예시

        GET {SERVER_API_URL}/getPublicIpInstanceList
        ?searchFilterName=associatedServerName
        &searchFilterValue=s1669aa4e78c
        HTTP

        응답 예시

        <getPublicIpInstanceListResponse>
          <requestId>9e27266d-049c-42c7-a04a-a884290dddb1</requestId>
          <returnCode>0</returnCode>
          <returnMessage>success</returnMessage>
          <totalRows>1</totalRows>
          <publicIpInstanceList>
            <publicIpInstance>
              <publicIpInstanceNo>1081432</publicIpInstanceNo>
              <publicIp>106.10.46.237</publicIp>
              <publicIpDescription></publicIpDescription>
              <createDate>2018-11-23T18:33:45+0900</createDate>
              <publicIpInstanceStatusName>used</publicIpInstanceStatusName>
              <publicIpInstanceStatus>
                <code>USED</code>
                <codeName>NET USED state</codeName>
              </publicIpInstanceStatus>
              <publicIpInstanceOperation>
                <code>NULL</code>
                <codeName>NET NULL OP</codeName>
              </publicIpInstanceOperation>
              <publicIpKindType>
                <code>GEN</code>
                <codeName>General</codeName>
              </publicIpKindType>
              <serverInstanceAssociatedWithPublicIp>
                <serverInstanceNo>1021003</serverInstanceNo>
                <serverName>s1669aa4e78c</serverName>
                <serverDescription>내서버이미지 카피 오류테스트</serverDescription>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX64</code>
                  <codeName>Linux 64 Bit</codeName>
                </platformType>
                <loginKeyName>juhoon-kim</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp>106.10.46.237</publicIp>
                <privateIp>10.41.3.81</privateIp>
                <serverImageName>tensorflow-centos-7.3-64</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2018-10-22T16:19:50+0900</createDate>
                <uptime>2018-11-23T17:38:44+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000066</serverImageProductCode>
                <serverProductCode>SPSVRSSD00000003</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>SSD</code>
                  <codeName>SSD</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>
        </getPublicIpInstanceListResponse>
        XML

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

        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.