getPolicy

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

개요

Policy 설정 내용을 조회합니다.
policyNo 미입력 시 가장 우선순위 낮은 Policy 가 조회됩니다.

요청

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

Type

Value	Description
szfw	Secure Zone Standard
psfw	Secure Zone Advanced

Zone

Value	Description
kr1	KR-1 Zone
kr2	KR-2 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 사용
x-ncp-mbr_no	사용자 번호

요청 파라미터

파라미터명	필수 여부	타입	설명	비고
policyName	no	String	정책명
policyNo	no	String	정책 번호

요청 바디

{
  "policyName": "string",
  "policyNo": 0
}

응답

응답 바디

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

응답 바디

{
  "action": "string",
  "policy": {
    "action": "string",
    "description": "string",
    "destinationAddressGroupList": [
      {
        "addressGroupName": "string",
        "addressGroupNo": 0,
        "addressList": [
          {
            "addressNo": 0,
            "addressZone": "string",
            "dbAddressZone": true,
            "fqdn": "string",
            "instanceNo": "string",
            "ip": "string",
            "maskBit": 0,
            "memberNo": "string",
            "name": "string",
            "port": "string",
            "type": "string"
          }
        ],
        "addressZone": "string",
        "associatedPoliciesCount": 0,
        "description": "string",
        "instanceNo": "string",
        "memberNo": "string",
        "objectStorage": true
      }
    ],
    "destinationAddressList": [
      {
        "addressNo": 0,
        "addressZone": "string",
        "dbAddressZone": true,
        "fqdn": "string",
        "instanceNo": "string",
        "ip": "string",
        "maskBit": 0,
        "memberNo": "string",
        "name": "string",
        "port": "string",
        "type": "string"
      }
    ],
    "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",
            "dbAddressZone": true,
            "fqdn": "string",
            "instanceNo": "string",
            "ip": "string",
            "maskBit": 0,
            "memberNo": "string",
            "name": "string",
            "port": "string",
            "type": "string"
          }
        ],
        "addressZone": "string",
        "associatedPoliciesCount": 0,
        "description": "string",
        "instanceNo": "string",
        "memberNo": "string",
        "objectStorage": true
      }
    ],
    "sourceAddressList": [
      {
        "addressNo": 0,
        "addressZone": "string",
        "dbAddressZone": true,
        "fqdn": "string",
        "instanceNo": "string",
        "ip": "string",
        "maskBit": 0,
        "memberNo": "string",
        "name": "string",
        "port": "string",
        "type": "string"
      }
    ],
    "sourceAddressZone": "string"
  },
  "returnCode": 0,
  "returnMessage": "string"
}

오류 코드

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

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

What's Next

getPolicyList

개요
요청
응답
오류 코드

태그

Secure Zone