mirror of
https://github.com/outbackdingo/firezone.git
synced 2026-01-27 18:18:55 +00:00
Why: * In order to manage a large number of Firezone Sites, Resources, Policies, etc... a REST API is needed as clicking through the UI is too time consuming, as well as prone to error. By providing a REST API Firezone customers will be able to manage things within their Firezone accounts with code.
97 lines
2.6 KiB
Elixir
97 lines
2.6 KiB
Elixir
defmodule API.GatewayController do
|
|
use API, :controller
|
|
use OpenApiSpex.ControllerSpecs
|
|
alias API.Pagination
|
|
alias Domain.Gateways
|
|
|
|
action_fallback API.FallbackController
|
|
|
|
tags ["Gateways"]
|
|
|
|
operation :index,
|
|
summary: "List Gateways",
|
|
parameters: [
|
|
gateway_group_id: [
|
|
in: :path,
|
|
description: "Gateway Group ID",
|
|
type: :string,
|
|
example: "00000000-0000-0000-0000-000000000000"
|
|
],
|
|
limit: [in: :query, description: "Limit Gateways returned", type: :integer, example: 10],
|
|
page_cursor: [in: :query, description: "Next/Prev page cursor", type: :string]
|
|
],
|
|
responses: [
|
|
ok: {"Gateway Response", "application/json", API.Schemas.Gateway.ListResponse}
|
|
]
|
|
|
|
# List Gateways
|
|
def index(conn, params) do
|
|
list_opts =
|
|
params
|
|
|> Pagination.params_to_list_opts()
|
|
|> Keyword.put(:preload, :online?)
|
|
|
|
with {:ok, gateways, metadata} <- Gateways.list_gateways(conn.assigns.subject, list_opts) do
|
|
render(conn, :index, gateways: gateways, metadata: metadata)
|
|
end
|
|
end
|
|
|
|
operation :show,
|
|
summary: "Show Gateway",
|
|
parameters: [
|
|
gateway_group_id: [
|
|
in: :path,
|
|
description: "Gateway Group ID",
|
|
type: :string,
|
|
example: "00000000-0000-0000-0000-000000000000"
|
|
],
|
|
id: [
|
|
in: :path,
|
|
description: "Gateway ID",
|
|
type: :string,
|
|
example: "00000000-0000-0000-0000-000000000000"
|
|
]
|
|
],
|
|
responses: [
|
|
ok: {"Gateway Response", "application/json", API.Schemas.Gateway.Response}
|
|
]
|
|
|
|
# Show a specific Gateway
|
|
def show(conn, %{"id" => id}) do
|
|
with {:ok, gateway} <-
|
|
Gateways.fetch_gateway_by_id(id, conn.assigns.subject, preload: :online?) do
|
|
render(conn, :show, gateway: gateway)
|
|
end
|
|
end
|
|
|
|
operation :delete,
|
|
summary: "Delete a Gateway",
|
|
parameters: [
|
|
gateway_group_id: [
|
|
in: :path,
|
|
description: "Gateway Group ID",
|
|
type: :string,
|
|
example: "00000000-0000-0000-0000-000000000000"
|
|
],
|
|
id: [
|
|
in: :path,
|
|
description: "Gateway ID",
|
|
type: :string,
|
|
example: "00000000-0000-0000-0000-000000000000"
|
|
]
|
|
],
|
|
responses: [
|
|
ok: {"Gateway Response", "application/json", API.Schemas.Gateway.Response}
|
|
]
|
|
|
|
# Delete a Gateway
|
|
def delete(conn, %{"id" => id}) do
|
|
subject = conn.assigns.subject
|
|
|
|
with {:ok, gateway} <- Gateways.fetch_gateway_by_id(id, subject),
|
|
{:ok, gateway} <- Gateways.delete_gateway(gateway, subject) do
|
|
render(conn, :show, gateway: gateway)
|
|
end
|
|
end
|
|
end
|