Use better naming for storage endpoint documentation

This commit is contained in:
Ingo Oppermann
2023-03-17 13:55:19 +01:00
parent f345707c63
commit 562b7aed92
4 changed files with 84 additions and 40 deletions

View File

@@ -1,5 +1,4 @@
// Package docs GENERATED BY SWAG; DO NOT EDIT
// This file was generated by swaggo/swag
// Code generated by swaggo/swag. DO NOT EDIT
package docs
import "github.com/swaggo/swag"
@@ -322,6 +321,9 @@ const docTemplate = `{
"produces": [
"application/json"
],
"tags": [
"v16.12.0"
],
"summary": "List all registered filesystems",
"operationId": "filesystem-3-list",
"responses": {
@@ -337,7 +339,7 @@ const docTemplate = `{
}
}
},
"/api/v3/fs/{name}": {
"/api/v3/fs/{storage}": {
"get": {
"security": [
{
@@ -348,13 +350,16 @@ const docTemplate = `{
"produces": [
"application/json"
],
"tags": [
"v16.7.2"
],
"summary": "List all files on a filesystem",
"operationId": "filesystem-3-list-files",
"parameters": [
{
"type": "string",
"description": "Name of the filesystem",
"name": "name",
"name": "storage",
"in": "path",
"required": true
},
@@ -390,7 +395,7 @@ const docTemplate = `{
}
}
},
"/api/v3/fs/{name}/{path}": {
"/api/v3/fs/{storage}/{filepath}": {
"get": {
"security": [
{
@@ -402,20 +407,23 @@ const docTemplate = `{
"application/data",
"application/json"
],
"tags": [
"v16.7.2"
],
"summary": "Fetch a file from a filesystem",
"operationId": "filesystem-3-get-file",
"parameters": [
{
"type": "string",
"description": "Name of the filesystem",
"name": "name",
"name": "storage",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Path to file",
"name": "path",
"name": "filepath",
"in": "path",
"required": true
}
@@ -455,20 +463,23 @@ const docTemplate = `{
"text/plain",
"application/json"
],
"tags": [
"v16.7.2"
],
"summary": "Add a file to a filesystem",
"operationId": "filesystem-3-put-file",
"parameters": [
{
"type": "string",
"description": "Name of the filesystem",
"name": "name",
"name": "storage",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Path to file",
"name": "path",
"name": "filepath",
"in": "path",
"required": true
},
@@ -516,20 +527,23 @@ const docTemplate = `{
"produces": [
"text/plain"
],
"tags": [
"v16.7.2"
],
"summary": "Remove a file from a filesystem",
"operationId": "filesystem-3-delete-file",
"parameters": [
{
"type": "string",
"description": "Name of the filesystem",
"name": "name",
"name": "storage",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Path to file",
"name": "path",
"name": "filepath",
"in": "path",
"required": true
}