getPolicyList

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

Policy 리스트를 조회합니다.

요청

Method	Request URI
POST	`https://securezonefirewall.apigw.gov-ntruss.com/api/v1/{type}/{zone}`

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key	네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2	Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용

요청 파라미터

파라미터명	필수 여부	타입	설명	비고
instanceNo	Yes	String	인스턴스 번호
memberNo	Yes	String	사용자 번호
page	No	Integer	페이지 인덱스	기본값 0
countPerPage	No	Integer	페이지 사이즈	기본값 0

요청 바디

{
  "countPerPage": 0,
  "instanceNo": "string",
  "memberNo": "string",
  "page": 0
}

응답

응답 바디

파라미터명	타입	설명
action	String	요청 유형
returnCode	Integer	응답 코드
returnMessage	String	응답 메세지
totalCount	Integer	Policy 개수
policyList[].policyNo	Integer	정책 번호
policyList[].policyName	String	정책명
policyList[].description	String	정책 설명
policyList[].action	String	허용 차단 구분(allow, deny)
policyList[].memberNo	String	멤버 번호
policyList[].instanceNo	String	인스턴스 번호
policyList[].sourceAddressZone	String	출발지 AddressZone 정보
policyList[].destinationAddressZone	String	목적지 AddressZone 정보
policyList[].firewallPolicyId	Integer	방화벽 정책 아이디
policyList[].firewallOrder	Integer	방화벽 정책 순서
policyList[].sourceAddressGroupList[].addressGroupName	String	Address Group명
policyList[].sourceAddressGroupList[].addressGroupNo	Integer	Address Group 번호
policyList[].sourceAddressGroupList[].addressList[].addressNo	Integer	Address 번호
policyList[].sourceAddressGroupList[].addressList[].addressZone	String	AddressZone 정보
policyList[].sourceAddressGroupList[].addressList[].dbAddressZone	Boolean	db AddressZone 여부
policyList[].sourceAddressGroupList[].addressList[].fqdn	String	fqdn
policyList[].sourceAddressGroupList[].addressList[].instanceNo	String	인스턴스 번호
policyList[].sourceAddressGroupList[].addressList[].ip	String	Ip
policyList[].sourceAddressGroupList[].addressList[].maskBit	Integer	MaskBit
policyList[].sourceAddressGroupList[].addressList[].memberNo	String	멤버 번호
policyList[].sourceAddressGroupList[].addressList[].name	String	Address명
policyList[].sourceAddressGroupList[].addressList[].port	String	Port
policyList[].sourceAddressGroupList[].addressList[].type	String	Address Type 정보(ipmask, fqdn)
policyList[].sourceAddressGroupList[].addressZone	String	AddressZone 정보
policyList[].sourceAddressGroupList[].associatedPoliciesCount	Integer	미사용
policyList[].sourceAddressGroupList[].description	String	설명
policyList[].sourceAddressGroupList[].instanceNo	String	인스턴스 번호
policyList[].sourceAddressGroupList[].memberNo	String	멤버 번호
policyList[].sourceAddressGroupList[].objectStorage	Boolean	오브젝트 스토리지 여부
policyList[].sourceAddressList[].addressNo	Integer	Address 번호
policyList[].sourceAddressList[].addressZone	String	AddressZone 정보
policyList[].sourceAddressList[].dbAddressZone	Boolean	db AddressZone 여부
policyList[].sourceAddressList[].fqdn	String	fqdn
policyList[].sourceAddressList[].instanceNo	String	인스턴스 번호
policyList[].sourceAddressList[].ip	String	Ip
policyList[].sourceAddressList[].maskBit	Integer	MaskBit
policyList[].sourceAddressList[].memberNo	String	멤버 번호
policyList[].sourceAddressList[].name	String	Address명
policyList[].sourceAddressList[].port	String	Port
policyList[].sourceAddressList[].type	String	Address Type 정보(ipmask, fqdn)
policyList[].destinationAddressGroupList[].addressGroupName	String	Address Group명
policyList[].destinationAddressGroupList[].addressGroupNo	Integer	Address Group 번호
policyList[].destinationAddressGroupList[].addressList[].addressNo	Integer	Address 번호
policyList[].destinationAddressGroupList[].addressList[].addressZone	String	AddressZone 정보
policyList[].destinationAddressGroupList[].addressList[].dbAddressZone	Boolean	db AddressZone 여부
policyList[].destinationAddressGroupList[].addressList[].fqdn	String	fqdn
policyList[].destinationAddressGroupList[].addressList[].instanceNo	String	인스턴스 번호
policyList[].destinationAddressGroupList[].addressList[].ip	String	Ip
policyList[].destinationAddressGroupList[].addressList[].maskBit	Integer	MaskBit
policyList[].destinationAddressGroupList[].addressList[].memberNo	String	멤버 번호
policyList[].destinationAddressGroupList[].addressList[].name	String	Address명
policyList[].destinationAddressGroupList[].addressList[].port	String	Port
policyList[].destinationAddressGroupList[].addressList[].type	String	Address Type 정보(ipmask, fqdn)
policyList[].destinationAddressGroupList[].addressZone	String	AddressZone 정보
policyList[].destinationAddressGroupList[].associatedPoliciesCount	Integer	미사용
policyList[].destinationAddressGroupList[].description	String	설명
policyList[].destinationAddressGroupList[].instanceNo	String	인스턴스 번호
policyList[].destinationAddressGroupList[].memberNo	String	멤버 번호
policyList[].destinationAddressGroupList[].objectStorage	Boolean	오브젝트 스토리지 여부
policyList[].destinationAddressList[].addressNo	Integer	Address 번호
policyList[].destinationAddressList[].addressZone	String	AddressZone 정보
policyList[].destinationAddressList[].dbAddressZone	Boolean	db AddressZone 여부
policyList[].destinationAddressList[].fqdn	String	fqdn
policyList[].destinationAddressList[].instanceNo	String	인스턴스 번호
policyList[].destinationAddressList[].ip	String	Ip
policyList[].destinationAddressList[].maskBit	Integer	MaskBit
policyList[].destinationAddressList[].memberNo	String	멤버 번호
policyList[].destinationAddressList[].name	String	Address명
policyList[].destinationAddressList[].port	String	Port
policyList[].destinationAddressList[].type	String	Address Type 정보(ipmask, fqdn)
policyList[].serviceList[].serviceNo	Integer	서비스 번호
policyList[].serviceList[].serviceName	String	서비스명
policyList[].serviceList[].protocol	String	방화벽 서비스 프로토콜
policyList[].serviceList[].port	String	방화벽 서비스 포트번호
policyList[].serviceList[].memberNo	String	멤버 번호
policyList[].serviceList[].instanceNo	String	인스턴스 번호

응답 바디

{
  "action": "string",
  "policyList": [
    {
      "action": "string",
      "description": "string",
      "destinationAddressGroupList": [
        {
          "addressGroupName": "string",
          "addressGroupNo": 0,
          "addressList": [
            {
              "addressNo": 0,
              "addressZone": "string",
              "fqdn": "string",
              "instanceNo": "string",
              "ip": "string",
              "maskBit": 0,
              "memberNo": "string",
              "name": "string",
              "port": "string",
              "type": "ipmask"
            }
          ],
          "addressZone": "string",
          "associatedPoliciesCount": 0,
          "description": "string",
          "instanceNo": "string",
          "memberNo": "string",
          "objectStorage": true
        }
      ],
      "destinationAddressList": [
        {
          "addressNo": 0,
          "addressZone": "string",
          "fqdn": "string",
          "instanceNo": "string",
          "ip": "string",
          "maskBit": 0,
          "memberNo": "string",
          "name": "string",
          "port": "string",
          "type": "ipmask"
        }
      ],
      "destinationAddressZone": "string",
      "firewallOrder": 0,
      "firewallPolicyId": 0,
      "instanceNo": "string",
      "memberNo": "string",
      "policyName": "string",
      "policyNo": 0,
      "serviceList": [
        {
          "instanceNo": "string",
          "memberNo": "string",
          "port": "string",
          "protocol": "string",
          "serviceName": "string",
          "serviceNo": 0
        }
      ],
      "sourceAddressGroupList": [
        {
          "addressGroupName": "string",
          "addressGroupNo": 0,
          "addressList": [
            {
              "addressNo": 0,
              "addressZone": "string",
              "fqdn": "string",
              "instanceNo": "string",
              "ip": "string",
              "maskBit": 0,
              "memberNo": "string",
              "name": "string",
              "port": "string",
              "type": "ipmask"
            }
          ],
          "addressZone": "string",
          "associatedPoliciesCount": 0,
          "description": "string",
          "instanceNo": "string",
          "memberNo": "string",
          "objectStorage": true
        }
      ],
      "sourceAddressList": [
        {
          "addressNo": 0,
          "addressZone": "string",
          "fqdn": "string",
          "instanceNo": "string",
          "ip": "string",
          "maskBit": 0,
          "memberNo": "string",
          "name": "string",
          "port": "string",
          "type": "ipmask"
        }
      ],
      "sourceAddressZone": "string"
    }
  ],
  "returnCode": 0,
  "returnMessage": "string",
  "totalCount": 0
}

오류 코드

공통적으로 발생하는 오류에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

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

What's Next

Secure Zone 개요

개요
요청
응답
오류 코드

태그

Secure Zone