http-filesystem Binding

Zilla runtime http-filesystem binding.

http_filesystem_proxy:
  type: http-filesystem
  kind: proxy
  routes:
    - when:
        - path: /{path}
      exit: filesystem_server
      with:
        path: ${params.path}

Summary

Defines a binding with http-filesystem support, with proxy behavior.

The proxy kind http-filesystem binding adapts http data streams into filesystem data streams by mapping the path from an inbound http GET request into a filesystem relative path.

Behaves as a web server when combined with tcp, tls, http and filesystem bindings.

Configuration

Properties

• kind*
• exit
• routes
• routes[].guarded
• routes[].when
  • when[].path*
• routes[].exit*
• routes[].with
  • with[].path*

* required

kind*

enum [ "proxy" ]

Behave as an http-filesystem proxy.

kind: proxy

exit

string

Default exit binding when no conditional routes are viable.

exit: filesystem_server

routes

array of object

Conditional http-kafka-specific routes for adapting http data streams into filesystem data streams.

routes:
  - when:
      - path: /{path}
    exit: filesystem_server
    with:
      path: ${params.path}

routes[].guarded

object as named map of string:string array

List of roles required by each named guard to authorize this route.

routes:
  - guarded:
      my_guard:
        - read:items

routes[].when

array of object

List of conditions (any match) to match this route when adapting http data streams into filesystem data streams.
Read more: When a route matches

routes:
  - when:
      - path: /{path}

when[].path*

string

Path with optional embedded parameter names, such as /{path}.

routes[].exit*

string

Next binding when following this route.

routes:
  - when:
    ...
    exit: filesystem_server

routes[].with

object

Filesystem parameters used when adapting http data streams into filesystem data streams.

with.path*

string

Topic name, optionally referencing path parameter such as ${params.path}.

---

* required