2021-10-29 18:43:10 +02:00
|
|
|
{
|
|
|
|
"swagger": "2.0",
|
|
|
|
"info": {
|
2021-10-30 16:29:41 +02:00
|
|
|
"title": "headscale/v1/headscale.proto",
|
2021-10-29 18:43:10 +02:00
|
|
|
"version": "version not set"
|
|
|
|
},
|
|
|
|
"tags": [
|
|
|
|
{
|
|
|
|
"name": "HeadscaleService"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"consumes": [
|
|
|
|
"application/json"
|
|
|
|
],
|
|
|
|
"produces": [
|
|
|
|
"application/json"
|
|
|
|
],
|
|
|
|
"paths": {
|
2022-01-25 23:11:15 +01:00
|
|
|
"/api/v1/apikey": {
|
|
|
|
"get": {
|
|
|
|
"operationId": "HeadscaleService_ListApiKeys",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ListApiKeysResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"post": {
|
|
|
|
"summary": "--- ApiKeys start ---",
|
|
|
|
"operationId": "HeadscaleService_CreateApiKey",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1CreateApiKeyResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1CreateApiKeyRequest"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/apikey/expire": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_ExpireApiKey",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ExpireApiKeyResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ExpireApiKeyRequest"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"/api/v1/debug/machine": {
|
|
|
|
"post": {
|
|
|
|
"summary": "--- Machine start ---",
|
|
|
|
"operationId": "HeadscaleService_DebugCreateMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1DebugCreateMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1DebugCreateMachineRequest"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/machine": {
|
|
|
|
"get": {
|
|
|
|
"operationId": "HeadscaleService_ListMachines",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ListMachinesResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "namespace",
|
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/machine/register": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_RegisterMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1RegisterMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2022-02-21 23:48:27 +01:00
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "namespace",
|
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"name": "key",
|
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
2021-11-04 23:07:59 +01:00
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-10-29 18:43:10 +02:00
|
|
|
"/api/v1/machine/{machineId}": {
|
|
|
|
"get": {
|
|
|
|
"operationId": "HeadscaleService_GetMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"$ref": "#/definitions/v1GetMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"delete": {
|
|
|
|
"operationId": "HeadscaleService_DeleteMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1DeleteMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-11-21 14:40:04 +01:00
|
|
|
"/api/v1/machine/{machineId}/expire": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_ExpireMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ExpireMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2022-05-01 15:34:40 +02:00
|
|
|
"/api/v1/machine/{machineId}/namespace": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_MoveMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1MoveMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"name": "namespace",
|
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2022-03-13 22:03:20 +01:00
|
|
|
"/api/v1/machine/{machineId}/rename/{newName}": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_RenameMachine",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1RenameMachineResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"name": "newName",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"/api/v1/machine/{machineId}/routes": {
|
|
|
|
"get": {
|
|
|
|
"summary": "--- Route start ---",
|
|
|
|
"operationId": "HeadscaleService_GetMachineRoute",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1GetMachineRouteResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_EnableMachineRoutes",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1EnableMachineRoutesResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
{
|
2022-02-21 23:48:27 +01:00
|
|
|
"name": "routes",
|
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"collectionFormat": "multi"
|
2021-11-04 23:07:59 +01:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2022-04-25 20:45:33 +02:00
|
|
|
"/api/v1/machine/{machineId}/tags": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_SetTags",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1SetTagsResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "machineId",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"tags": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"/api/v1/namespace": {
|
|
|
|
"get": {
|
|
|
|
"operationId": "HeadscaleService_ListNamespaces",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ListNamespacesResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_CreateNamespace",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1CreateNamespaceResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1CreateNamespaceRequest"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/namespace/{name}": {
|
|
|
|
"get": {
|
|
|
|
"summary": "--- Namespace start ---",
|
|
|
|
"operationId": "HeadscaleService_GetNamespace",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1GetNamespaceResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "name",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"delete": {
|
|
|
|
"operationId": "HeadscaleService_DeleteNamespace",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1DeleteNamespaceResponse"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
2021-11-04 23:07:59 +01:00
|
|
|
"name": "name",
|
2021-10-29 18:43:10 +02:00
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
2021-11-04 23:07:59 +01:00
|
|
|
"type": "string"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"/api/v1/namespace/{oldName}/rename/{newName}": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_RenameNamespace",
|
2021-10-29 18:43:10 +02:00
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"$ref": "#/definitions/v1RenameNamespaceResponse"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "oldName",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"name": "newName",
|
|
|
|
"in": "path",
|
|
|
|
"required": true,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
2021-10-29 18:43:10 +02:00
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
2021-11-04 23:07:59 +01:00
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/preauthkey": {
|
|
|
|
"get": {
|
|
|
|
"operationId": "HeadscaleService_ListPreAuthKeys",
|
2021-10-29 18:43:10 +02:00
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"$ref": "#/definitions/v1ListPreAuthKeysResponse"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
2021-11-04 23:07:59 +01:00
|
|
|
"name": "namespace",
|
2021-10-29 18:43:10 +02:00
|
|
|
"in": "query",
|
|
|
|
"required": false,
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
},
|
|
|
|
"post": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"summary": "--- PreAuthKeys start ---",
|
|
|
|
"operationId": "HeadscaleService_CreatePreAuthKey",
|
2021-10-29 18:43:10 +02:00
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"$ref": "#/definitions/v1CreatePreAuthKeyResponse"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"$ref": "#/definitions/v1CreatePreAuthKeyRequest"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"/api/v1/preauthkey/expire": {
|
|
|
|
"post": {
|
|
|
|
"operationId": "HeadscaleService_ExpirePreAuthKey",
|
|
|
|
"responses": {
|
|
|
|
"200": {
|
|
|
|
"description": "A successful response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ExpirePreAuthKeyResponse"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"default": {
|
|
|
|
"description": "An unexpected error response.",
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/rpcStatus"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"parameters": [
|
|
|
|
{
|
|
|
|
"name": "body",
|
|
|
|
"in": "body",
|
|
|
|
"required": true,
|
|
|
|
"schema": {
|
|
|
|
"$ref": "#/definitions/v1ExpirePreAuthKeyRequest"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"tags": [
|
|
|
|
"HeadscaleService"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"definitions": {
|
|
|
|
"protobufAny": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"@type": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"additionalProperties": {}
|
|
|
|
},
|
|
|
|
"rpcStatus": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"code": {
|
|
|
|
"type": "integer",
|
|
|
|
"format": "int32"
|
|
|
|
},
|
|
|
|
"message": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"details": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"$ref": "#/definitions/protobufAny"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2022-01-25 23:11:15 +01:00
|
|
|
"v1ApiKey": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"id": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
"prefix": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"expiration": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
},
|
|
|
|
"createdAt": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
},
|
|
|
|
"lastSeen": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1CreateApiKeyRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"expiration": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1CreateApiKeyResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"apiKey": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-10-29 18:43:10 +02:00
|
|
|
"v1CreateNamespaceRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"name": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1CreateNamespaceResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"namespace": {
|
|
|
|
"$ref": "#/definitions/v1Namespace"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1CreatePreAuthKeyRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
2021-11-08 21:47:40 +01:00
|
|
|
"reusable": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"type": "boolean"
|
|
|
|
},
|
|
|
|
"ephemeral": {
|
|
|
|
"type": "boolean"
|
|
|
|
},
|
|
|
|
"expiration": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1CreatePreAuthKeyResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"preAuthKey": {
|
|
|
|
"$ref": "#/definitions/v1PreAuthKey"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1DebugCreateMachineRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"key": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
2021-10-29 18:43:10 +02:00
|
|
|
"name": {
|
|
|
|
"type": "string"
|
2021-11-04 23:07:59 +01:00
|
|
|
},
|
|
|
|
"routes": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1DebugCreateMachineResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1DeleteMachineResponse": {
|
|
|
|
"type": "object"
|
|
|
|
},
|
2021-10-29 18:43:10 +02:00
|
|
|
"v1DeleteNamespaceResponse": {
|
|
|
|
"type": "object"
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1EnableMachineRoutesResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"routes": {
|
|
|
|
"$ref": "#/definitions/v1Routes"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2022-01-25 23:11:15 +01:00
|
|
|
"v1ExpireApiKeyRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"prefix": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1ExpireApiKeyResponse": {
|
|
|
|
"type": "object"
|
|
|
|
},
|
2021-11-21 14:40:04 +01:00
|
|
|
"v1ExpireMachineResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1ExpirePreAuthKeyRequest": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"key": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1ExpirePreAuthKeyResponse": {
|
|
|
|
"type": "object"
|
|
|
|
},
|
2021-10-29 18:43:10 +02:00
|
|
|
"v1GetMachineResponse": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1GetMachineRouteResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"routes": {
|
|
|
|
"$ref": "#/definitions/v1Routes"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1GetNamespaceResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"$ref": "#/definitions/v1Namespace"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2022-01-25 23:11:15 +01:00
|
|
|
"v1ListApiKeysResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"apiKeys": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"$ref": "#/definitions/v1ApiKey"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1ListMachinesResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machines": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1ListNamespacesResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespaces": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"$ref": "#/definitions/v1Namespace"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1ListPreAuthKeysResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"preAuthKeys": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"$ref": "#/definitions/v1PreAuthKey"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1Machine": {
|
2021-10-29 18:43:10 +02:00
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"id": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "uint64"
|
|
|
|
},
|
|
|
|
"machineKey": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"nodeKey": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"discoKey": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
2022-01-16 14:15:35 +01:00
|
|
|
"ipAddresses": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
2021-10-29 18:43:10 +02:00
|
|
|
},
|
|
|
|
"name": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"namespace": {
|
|
|
|
"$ref": "#/definitions/v1Namespace"
|
2021-10-29 18:43:10 +02:00
|
|
|
},
|
|
|
|
"lastSeen": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
},
|
|
|
|
"lastSuccessfulUpdate": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
},
|
|
|
|
"expiry": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
2021-11-04 23:07:59 +01:00
|
|
|
},
|
|
|
|
"preAuthKey": {
|
|
|
|
"$ref": "#/definitions/v1PreAuthKey"
|
|
|
|
},
|
|
|
|
"createdAt": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
2022-02-28 23:21:14 +01:00
|
|
|
},
|
|
|
|
"registerMethod": {
|
|
|
|
"$ref": "#/definitions/v1RegisterMethod"
|
2022-03-13 22:03:20 +01:00
|
|
|
},
|
2022-04-15 13:11:41 +02:00
|
|
|
"forcedTags": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
2022-04-16 11:30:51 +02:00
|
|
|
},
|
|
|
|
"invalidTags": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"validTags": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
2022-05-16 21:41:46 +02:00
|
|
|
},
|
2022-04-24 21:55:20 +02:00
|
|
|
"givenName": {
|
2022-03-13 22:03:20 +01:00
|
|
|
"type": "string"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2022-05-01 15:34:40 +02:00
|
|
|
"v1MoveMachineResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1Namespace": {
|
2021-10-29 18:43:10 +02:00
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"id": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"name": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"createdAt": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1PreAuthKey": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"id": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
|
|
|
"key": {
|
|
|
|
"type": "string"
|
|
|
|
},
|
2021-11-08 21:47:40 +01:00
|
|
|
"reusable": {
|
2021-11-04 23:07:59 +01:00
|
|
|
"type": "boolean"
|
|
|
|
},
|
|
|
|
"ephemeral": {
|
|
|
|
"type": "boolean"
|
|
|
|
},
|
|
|
|
"used": {
|
|
|
|
"type": "boolean"
|
|
|
|
},
|
|
|
|
"expiration": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
},
|
|
|
|
"createdAt": {
|
|
|
|
"type": "string",
|
|
|
|
"format": "date-time"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1RegisterMachineResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1RegisterMethod": {
|
|
|
|
"type": "string",
|
|
|
|
"enum": [
|
|
|
|
"REGISTER_METHOD_UNSPECIFIED",
|
|
|
|
"REGISTER_METHOD_AUTH_KEY",
|
|
|
|
"REGISTER_METHOD_CLI",
|
|
|
|
"REGISTER_METHOD_OIDC"
|
|
|
|
],
|
|
|
|
"default": "REGISTER_METHOD_UNSPECIFIED"
|
2021-11-04 23:07:59 +01:00
|
|
|
},
|
2022-03-13 22:03:20 +01:00
|
|
|
"v1RenameMachineResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
2021-11-04 23:07:59 +01:00
|
|
|
"v1RenameNamespaceResponse": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"namespace": {
|
|
|
|
"$ref": "#/definitions/v1Namespace"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"v1Routes": {
|
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"advertisedRoutes": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"enabledRoutes": {
|
|
|
|
"type": "array",
|
|
|
|
"items": {
|
|
|
|
"type": "string"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2022-04-15 13:11:41 +02:00
|
|
|
},
|
2022-04-25 20:45:33 +02:00
|
|
|
"v1SetTagsResponse": {
|
2022-04-15 13:11:41 +02:00
|
|
|
"type": "object",
|
|
|
|
"properties": {
|
|
|
|
"machine": {
|
|
|
|
"$ref": "#/definitions/v1Machine"
|
|
|
|
}
|
|
|
|
}
|
2021-10-29 18:43:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|