getPublicIpInstanceList
    • PDF

    getPublicIpInstanceList

    • PDF

    기사 요약

    개요

    공인 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
    

    응답 예시

    <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>
    

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

    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.