Firewall

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다. 본 가이드는 Firewall 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

OpenAPI URL

https://firewall.{region}.{environment}.samsungsdscloud.com

Environment and Region List

API Version History

1.1

Firewall API 버전 1.1이 출시되었습니다.

변경사항

• [변경] GET /v1/firewalls - List Firewalls API가 변경되었습니다.
  • 응답 모델이 FirewallListResponseV1Dot1 로 변경되었습니다.
    • 응답 시, 아래와 같은 필드가 추가됩니다.
      • zone_resources
    • 응답 시, 아래와 같은 필드가 삭제됩니다.
      • fw_resource_id
• [변경] GET /v1/firewalls/{firewall_id} - Show Firewall API가 변경되었습니다.
  • 응답 모델이 FirewallShowResponseV1Dot1 로 변경되었습니다.
    • 응답 시, 아래와 같은 필드가 추가됩니다.
      • zone_resources
    • 응답 시, 아래와 같은 필드가 삭제됩니다.
      • fw_resource_id
• [변경] PUT /v1/firewalls/{firewall_id} - Set Firewall API가 변경되었습니다.
  • 응답 모델이 FirewallShowResponseV1Dot1 로 변경되었습니다.
    • 응답 시, 아래와 같은 필드가 추가됩니다.
      • zone_resources
    • 응답 시, 아래와 같은 필드가 삭제됩니다.
      • fw_resource_id
• [변경] GET /v1/firewalls/rules - List Firewall Rules API가 변경되었습니다.
  • 요청 시, 아래와 같은 쿼리 파라미터가 삭제됩니다.
    • fetch_all
  • 응답 모델이 FirewallRuleListResponseV1Dot1 로 변경되었습니다.
    • 응답 시, 아래와 같은 필드가 삭제됩니다.
      • destination_interface, name, source_interface, vendor_rule_id
• [변경] GET /v1/firewalls/rules/{firewall_rule_id} - Show Firewall Rule API가 변경되었습니다.
  • 응답 모델이 FirewallRuleShowResponseV1Dot1 로 변경되었습니다.
    • 응답 시, 아래와 같은 필드가 삭제됩니다.
      • destination_interface, name, source_interface, vendor_rule_id
• [변경] POST /v1/firewalls/rules - Create Firewall Rule API가 변경되었습니다.
  • 비동기 처리로 변경되었습니다.
  • 응답 코드가 201 Created에서 202 Accepted로 변경되어 응답 본문이 반환되지 않습니다.
  • 요청 모델이 FirewallRuleCreateSingleRequest 로 변경되었습니다.
    • 요청 시, 아래와 같은 필드가 삭제됩니다.
      • destination_interface, name, source_interface
• [변경] PUT /v1/firewalls/rules/{firewall_rule_id} - Set Firewall Rule API가 변경되었습니다.
  • 비동기 처리로 변경되었습니다.
  • 응답 코드가 200 OK에서 202 Accepted로 변경되어 응답 본문이 반환되지 않습니다.
  • 요청 모델이 FirewallRuleUpdateSingleRequest 로 변경되었습니다.
    • 요청 시, 아래와 같은 필드가 추가됩니다.
      • order_direction, order_rule_id, status
• [변경] DELETE /v1/firewalls/rules/{firewall_rule_id} - Delete Firewall Rule API가 변경되었습니다.
  • 비동기 처리로 변경되었습니다.
  • 응답 코드가 204 No Content에서 202 Accepted로 변경되었습니다.

1.0

Firewall API가 출시되었습니다.

변경사항

• [신규] GET /v1/firewalls - API가 추가되었습니다.
• [신규] GET /v1/firewalls/{firewall_id} - API가 추가되었습니다.
• [신규] PUT /v1/firewalls/{firewall_id} - API가 추가되었습니다.
• [신규] GET /v1/firewalls/rules - API가 추가되었습니다.
• [신규] POST /v1/firewalls/rules - API가 추가되었습니다.
• [신규] GET /v1/firewalls/rules/{firewall_rule_id} - API가 추가되었습니다.
• [신규] PUT /v1/firewalls/rules/{firewall_rule_id} - API가 추가되었습니다.
• [신규] DELETE /v1/firewalls/rules/{firewall_rule_id} - API가 추가되었습니다.