getPolicy

인쇄
공유
PDF

기사 요약

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

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

개요

Policy 설정 내용을 조회합니다.
policyNo 미입력 시 가장 우선순위 낮은 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
policyName	No	String
policyNo	No	Integer

요청 바디

{
  "instanceNo": "string",
  "memberNo": "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

getMemberInfo

개요
요청
응답
오류 코드

태그

Secure Zone