mirror of https://github.com/grafana/grafana.git
				
				
				
			
		
			
				
	
	
		
			1056 lines
		
	
	
		
			33 KiB
		
	
	
	
		
			Go
		
	
	
	
			
		
		
	
	
			1056 lines
		
	
	
		
			33 KiB
		
	
	
	
		
			Go
		
	
	
	
package api
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"encoding/json"
 | 
						|
	"errors"
 | 
						|
	"fmt"
 | 
						|
	"net/http"
 | 
						|
	"sort"
 | 
						|
	"strconv"
 | 
						|
	"strings"
 | 
						|
 | 
						|
	"github.com/grafana/grafana-plugin-sdk-go/backend"
 | 
						|
 | 
						|
	"github.com/grafana/grafana/pkg/api/datasource"
 | 
						|
	"github.com/grafana/grafana/pkg/api/dtos"
 | 
						|
	"github.com/grafana/grafana/pkg/api/response"
 | 
						|
	"github.com/grafana/grafana/pkg/components/simplejson"
 | 
						|
	"github.com/grafana/grafana/pkg/infra/log"
 | 
						|
	"github.com/grafana/grafana/pkg/plugins/adapters"
 | 
						|
	contextmodel "github.com/grafana/grafana/pkg/services/contexthandler/model"
 | 
						|
	"github.com/grafana/grafana/pkg/services/datasources"
 | 
						|
	"github.com/grafana/grafana/pkg/services/datasources/permissions"
 | 
						|
	"github.com/grafana/grafana/pkg/services/user"
 | 
						|
	"github.com/grafana/grafana/pkg/setting"
 | 
						|
	"github.com/grafana/grafana/pkg/util"
 | 
						|
	"github.com/grafana/grafana/pkg/web"
 | 
						|
)
 | 
						|
 | 
						|
var datasourcesLogger = log.New("datasources")
 | 
						|
var secretsPluginError datasources.ErrDatasourceSecretsPluginUserFriendly
 | 
						|
 | 
						|
// swagger:route GET /datasources datasources getDataSources
 | 
						|
//
 | 
						|
// Get all data sources.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:read` and scope: `datasources:*`.
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: getDataSourcesResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) GetDataSources(c *contextmodel.ReqContext) response.Response {
 | 
						|
	query := datasources.GetDataSourcesQuery{OrgID: c.OrgID, DataSourceLimit: hs.Cfg.DataSourceLimit}
 | 
						|
 | 
						|
	dataSources, err := hs.DataSourcesService.GetDataSources(c.Req.Context(), &query)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(500, "Failed to query datasources", err)
 | 
						|
	}
 | 
						|
 | 
						|
	filtered, err := hs.filterDatasourcesByQueryPermission(c.Req.Context(), c.SignedInUser, dataSources)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(500, "Failed to query datasources", err)
 | 
						|
	}
 | 
						|
 | 
						|
	result := make(dtos.DataSourceList, 0)
 | 
						|
	for _, ds := range filtered {
 | 
						|
		dsItem := dtos.DataSourceListItemDTO{
 | 
						|
			OrgId:     ds.OrgID,
 | 
						|
			Id:        ds.ID,
 | 
						|
			UID:       ds.UID,
 | 
						|
			Name:      ds.Name,
 | 
						|
			Url:       ds.URL,
 | 
						|
			Type:      ds.Type,
 | 
						|
			TypeName:  ds.Type,
 | 
						|
			Access:    ds.Access,
 | 
						|
			Database:  ds.Database,
 | 
						|
			User:      ds.User,
 | 
						|
			BasicAuth: ds.BasicAuth,
 | 
						|
			IsDefault: ds.IsDefault,
 | 
						|
			JsonData:  ds.JsonData,
 | 
						|
			ReadOnly:  ds.ReadOnly,
 | 
						|
		}
 | 
						|
 | 
						|
		if plugin, exists := hs.pluginStore.Plugin(c.Req.Context(), ds.Type); exists {
 | 
						|
			dsItem.TypeLogoUrl = plugin.Info.Logos.Small
 | 
						|
			dsItem.TypeName = plugin.Name
 | 
						|
		} else {
 | 
						|
			dsItem.TypeLogoUrl = "public/img/icn-datasource.svg"
 | 
						|
		}
 | 
						|
 | 
						|
		result = append(result, dsItem)
 | 
						|
	}
 | 
						|
 | 
						|
	sort.Sort(result)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, &result)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/{id} datasources getDataSourceByID
 | 
						|
//
 | 
						|
// Get a single data source by Id.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).
 | 
						|
//
 | 
						|
// Please refer to [updated API](#/datasources/getDataSourceByUID) instead
 | 
						|
//
 | 
						|
// Deprecated: true
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: getDataSourceResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) GetDataSourceById(c *contextmodel.ReqContext) response.Response {
 | 
						|
	id, err := strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "id is invalid", nil)
 | 
						|
	}
 | 
						|
	query := datasources.GetDataSourceQuery{
 | 
						|
		ID:    id,
 | 
						|
		OrgID: c.OrgID,
 | 
						|
	}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(c.Req.Context(), &query)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceIdentifierNotSet) {
 | 
						|
			return response.Error(400, "Datasource id is missing", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to query datasources", err)
 | 
						|
	}
 | 
						|
 | 
						|
	dto := hs.convertModelToDtos(c.Req.Context(), dataSource)
 | 
						|
 | 
						|
	// Add accesscontrol metadata
 | 
						|
	dto.AccessControl = hs.getAccessControlMetadata(c, c.OrgID, datasources.ScopePrefix, dto.UID)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, &dto)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route DELETE /datasources/{id} datasources deleteDataSourceByID
 | 
						|
//
 | 
						|
// Delete an existing data source by id.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).
 | 
						|
//
 | 
						|
// Please refer to [updated API](#/datasources/deleteDataSourceByUID) instead
 | 
						|
//
 | 
						|
// Deprecated: true
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 404: notFoundError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) DeleteDataSourceById(c *contextmodel.ReqContext) response.Response {
 | 
						|
	id, err := strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "id is invalid", err)
 | 
						|
	}
 | 
						|
 | 
						|
	if id <= 0 {
 | 
						|
		return response.Error(400, "Missing valid datasource id", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.getRawDataSourceById(c.Req.Context(), id, c.OrgID)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(400, "Failed to delete datasource", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	if ds.ReadOnly {
 | 
						|
		return response.Error(403, "Cannot delete read-only data source", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	cmd := &datasources.DeleteDataSourceCommand{ID: id, OrgID: c.OrgID, Name: ds.Name}
 | 
						|
 | 
						|
	err = hs.DataSourcesService.DeleteDataSource(c.Req.Context(), cmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.As(err, &secretsPluginError) {
 | 
						|
			return response.Error(500, "Failed to delete datasource: "+err.Error(), err)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to delete datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	hs.Live.HandleDatasourceDelete(c.OrgID, ds.UID)
 | 
						|
 | 
						|
	return response.Success("Data source deleted")
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/uid/{uid} datasources getDataSourceByUID
 | 
						|
//
 | 
						|
// Get a single data source by UID.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:kLtEtcRGk` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: getDataSourceResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) GetDataSourceByUID(c *contextmodel.ReqContext) response.Response {
 | 
						|
	ds, err := hs.getRawDataSourceByUID(c.Req.Context(), web.Params(c.Req)[":uid"], c.OrgID)
 | 
						|
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(http.StatusNotFound, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(http.StatusInternalServerError, "Failed to query datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	dto := hs.convertModelToDtos(c.Req.Context(), ds)
 | 
						|
 | 
						|
	// Add accesscontrol metadata
 | 
						|
	dto.AccessControl = hs.getAccessControlMetadata(c, c.OrgID, datasources.ScopePrefix, dto.UID)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, &dto)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route DELETE /datasources/uid/{uid} datasources deleteDataSourceByUID
 | 
						|
//
 | 
						|
// Delete an existing data source by UID.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:kLtEtcRGk` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) DeleteDataSourceByUID(c *contextmodel.ReqContext) response.Response {
 | 
						|
	uid := web.Params(c.Req)[":uid"]
 | 
						|
 | 
						|
	if uid == "" {
 | 
						|
		return response.Error(400, "Missing datasource uid", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.getRawDataSourceByUID(c.Req.Context(), uid, c.OrgID)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(400, "Failed to delete datasource", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	if ds.ReadOnly {
 | 
						|
		return response.Error(403, "Cannot delete read-only data source", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	cmd := &datasources.DeleteDataSourceCommand{UID: uid, OrgID: c.OrgID, Name: ds.Name}
 | 
						|
 | 
						|
	err = hs.DataSourcesService.DeleteDataSource(c.Req.Context(), cmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.As(err, &secretsPluginError) {
 | 
						|
			return response.Error(500, "Failed to delete datasource: "+err.Error(), err)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to delete datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	hs.Live.HandleDatasourceDelete(c.OrgID, ds.UID)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, util.DynMap{
 | 
						|
		"message": "Data source deleted",
 | 
						|
		"id":      ds.ID,
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route DELETE /datasources/name/{name} datasources deleteDataSourceByName
 | 
						|
//
 | 
						|
// Delete an existing data source by name.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: deleteDataSourceByNameResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) DeleteDataSourceByName(c *contextmodel.ReqContext) response.Response {
 | 
						|
	name := web.Params(c.Req)[":name"]
 | 
						|
 | 
						|
	if name == "" {
 | 
						|
		return response.Error(400, "Missing valid datasource name", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	getCmd := &datasources.GetDataSourceQuery{Name: name, OrgID: c.OrgID}
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(c.Req.Context(), getCmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to delete datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	if dataSource.ReadOnly {
 | 
						|
		return response.Error(403, "Cannot delete read-only data source", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	cmd := &datasources.DeleteDataSourceCommand{Name: name, OrgID: c.OrgID}
 | 
						|
	err = hs.DataSourcesService.DeleteDataSource(c.Req.Context(), cmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.As(err, &secretsPluginError) {
 | 
						|
			return response.Error(500, "Failed to delete datasource: "+err.Error(), err)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to delete datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	hs.Live.HandleDatasourceDelete(c.OrgID, dataSource.UID)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, util.DynMap{
 | 
						|
		"message": "Data source deleted",
 | 
						|
		"id":      dataSource.ID,
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
func validateURL(cmdType string, url string) response.Response {
 | 
						|
	if _, err := datasource.ValidateURL(cmdType, url); err != nil {
 | 
						|
		datasourcesLogger.Error("Failed to validate URL", "url", url)
 | 
						|
		return response.Error(http.StatusBadRequest, "Validation error, invalid URL", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// validateJSONData prevents the user from adding a custom header with name that matches the auth proxy header name.
 | 
						|
// This is done to prevent data source proxy from being used to circumvent auth proxy.
 | 
						|
// For more context take a look at CVE-2022-35957
 | 
						|
func validateJSONData(jsonData *simplejson.Json, cfg *setting.Cfg) error {
 | 
						|
	if jsonData == nil || !cfg.AuthProxyEnabled {
 | 
						|
		return nil
 | 
						|
	}
 | 
						|
 | 
						|
	for key, value := range jsonData.MustMap() {
 | 
						|
		if strings.HasPrefix(key, "httpHeaderName") {
 | 
						|
			header := fmt.Sprint(value)
 | 
						|
			if http.CanonicalHeaderKey(header) == http.CanonicalHeaderKey(cfg.AuthProxyHeaderName) {
 | 
						|
				datasourcesLogger.Error("Forbidden to add a data source header with a name equal to auth proxy header name", "headerName", key)
 | 
						|
				return errors.New("validation error, invalid header name specified")
 | 
						|
			}
 | 
						|
		}
 | 
						|
	}
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route POST /datasources datasources addDataSource
 | 
						|
//
 | 
						|
// Create a data source.
 | 
						|
//
 | 
						|
// By defining `password` and `basicAuthPassword` under secureJsonData property
 | 
						|
// Grafana encrypts them securely as an encrypted blob in the database.
 | 
						|
// The response then lists the encrypted fields under secureJsonFields.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:create`
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: createOrUpdateDatasourceResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 409: conflictError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) AddDataSource(c *contextmodel.ReqContext) response.Response {
 | 
						|
	cmd := datasources.AddDataSourceCommand{}
 | 
						|
	if err := web.Bind(c.Req, &cmd); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "bad request data", err)
 | 
						|
	}
 | 
						|
 | 
						|
	datasourcesLogger.Debug("Received command to add data source", "url", cmd.URL)
 | 
						|
	cmd.OrgID = c.OrgID
 | 
						|
	cmd.UserID = c.UserID
 | 
						|
	if cmd.URL != "" {
 | 
						|
		if resp := validateURL(cmd.Type, cmd.URL); resp != nil {
 | 
						|
			return resp
 | 
						|
		}
 | 
						|
	}
 | 
						|
	if err := validateJSONData(cmd.JsonData, hs.Cfg); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "Failed to add datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.AddDataSource(c.Req.Context(), &cmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNameExists) || errors.Is(err, datasources.ErrDataSourceUidExists) {
 | 
						|
			return response.Error(409, err.Error(), err)
 | 
						|
		}
 | 
						|
 | 
						|
		if errors.As(err, &secretsPluginError) {
 | 
						|
			return response.Error(500, "Failed to add datasource: "+err.Error(), err)
 | 
						|
		}
 | 
						|
 | 
						|
		return response.Error(500, "Failed to add datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	// Clear permission cache for the user who's created the data source, so that new permissions are fetched for their next call
 | 
						|
	// Required for cases when caller wants to immediately interact with the newly created object
 | 
						|
	if !hs.AccessControl.IsDisabled() {
 | 
						|
		hs.accesscontrolService.ClearUserPermissionCache(c.SignedInUser)
 | 
						|
	}
 | 
						|
 | 
						|
	ds := hs.convertModelToDtos(c.Req.Context(), dataSource)
 | 
						|
	return response.JSON(http.StatusOK, util.DynMap{
 | 
						|
		"message":    "Datasource added",
 | 
						|
		"id":         dataSource.ID,
 | 
						|
		"name":       dataSource.Name,
 | 
						|
		"datasource": ds,
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route PUT /datasources/{id} datasources updateDataSourceByID
 | 
						|
//
 | 
						|
// Update an existing data source by its sequential ID.
 | 
						|
//
 | 
						|
// Similar to creating a data source, `password` and `basicAuthPassword` should be defined under
 | 
						|
// secureJsonData in order to be stored securely as an encrypted blob in the database. Then, the
 | 
						|
// encrypted fields are listed under secureJsonFields section in the response.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:write` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).
 | 
						|
//
 | 
						|
// Please refer to [updated API](#/datasources/updateDataSourceByUID) instead
 | 
						|
//
 | 
						|
// Deprecated: true
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: createOrUpdateDatasourceResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
 | 
						|
func (hs *HTTPServer) UpdateDataSourceByID(c *contextmodel.ReqContext) response.Response {
 | 
						|
	cmd := datasources.UpdateDataSourceCommand{}
 | 
						|
	if err := web.Bind(c.Req, &cmd); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "bad request data", err)
 | 
						|
	}
 | 
						|
	datasourcesLogger.Debug("Received command to update data source", "url", cmd.URL)
 | 
						|
	cmd.OrgID = c.OrgID
 | 
						|
	var err error
 | 
						|
	if cmd.ID, err = strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "id is invalid", err)
 | 
						|
	}
 | 
						|
	if resp := validateURL(cmd.Type, cmd.URL); resp != nil {
 | 
						|
		return resp
 | 
						|
	}
 | 
						|
	if err := validateJSONData(cmd.JsonData, hs.Cfg); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "Failed to update datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.getRawDataSourceById(c.Req.Context(), cmd.ID, cmd.OrgID)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to update datasource", err)
 | 
						|
	}
 | 
						|
	return hs.updateDataSourceByID(c, ds, cmd)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route PUT /datasources/uid/{uid} datasources updateDataSourceByUID
 | 
						|
//
 | 
						|
// Update an existing data source.
 | 
						|
//
 | 
						|
// Similar to creating a data source, `password` and `basicAuthPassword` should be defined under
 | 
						|
// secureJsonData in order to be stored securely as an encrypted blob in the database. Then, the
 | 
						|
// encrypted fields are listed under secureJsonFields section in the response.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:write` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:1` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: createOrUpdateDatasourceResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) UpdateDataSourceByUID(c *contextmodel.ReqContext) response.Response {
 | 
						|
	cmd := datasources.UpdateDataSourceCommand{}
 | 
						|
	if err := web.Bind(c.Req, &cmd); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "bad request data", err)
 | 
						|
	}
 | 
						|
	datasourcesLogger.Debug("Received command to update data source", "url", cmd.URL)
 | 
						|
	cmd.OrgID = c.OrgID
 | 
						|
	if resp := validateURL(cmd.Type, cmd.URL); resp != nil {
 | 
						|
		return resp
 | 
						|
	}
 | 
						|
	if err := validateJSONData(cmd.JsonData, hs.Cfg); err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "Failed to update datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.getRawDataSourceByUID(c.Req.Context(), web.Params(c.Req)[":uid"], c.OrgID)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(http.StatusNotFound, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(http.StatusInternalServerError, "Failed to update datasource", err)
 | 
						|
	}
 | 
						|
	cmd.ID = ds.ID
 | 
						|
	return hs.updateDataSourceByID(c, ds, cmd)
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) updateDataSourceByID(c *contextmodel.ReqContext, ds *datasources.DataSource, cmd datasources.UpdateDataSourceCommand) response.Response {
 | 
						|
	if ds.ReadOnly {
 | 
						|
		return response.Error(403, "Cannot update read-only data source", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	_, err := hs.DataSourcesService.UpdateDataSource(c.Req.Context(), &cmd)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceUpdatingOldVersion) {
 | 
						|
			return response.Error(409, "Datasource has already been updated by someone else. Please reload and try again", err)
 | 
						|
		}
 | 
						|
 | 
						|
		if errors.As(err, &secretsPluginError) {
 | 
						|
			return response.Error(500, "Failed to update datasource: "+err.Error(), err)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to update datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	query := datasources.GetDataSourceQuery{
 | 
						|
		ID:    cmd.ID,
 | 
						|
		OrgID: c.OrgID,
 | 
						|
	}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(c.Req.Context(), &query)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to query datasource", err)
 | 
						|
	}
 | 
						|
 | 
						|
	datasourceDTO := hs.convertModelToDtos(c.Req.Context(), dataSource)
 | 
						|
 | 
						|
	hs.Live.HandleDatasourceUpdate(c.OrgID, datasourceDTO.UID)
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, util.DynMap{
 | 
						|
		"message":    "Datasource updated",
 | 
						|
		"id":         cmd.ID,
 | 
						|
		"name":       cmd.Name,
 | 
						|
		"datasource": datasourceDTO,
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) getRawDataSourceById(ctx context.Context, id int64, orgID int64) (*datasources.DataSource, error) {
 | 
						|
	query := datasources.GetDataSourceQuery{
 | 
						|
		ID:    id,
 | 
						|
		OrgID: orgID,
 | 
						|
	}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(ctx, &query)
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return dataSource, nil
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) getRawDataSourceByUID(ctx context.Context, uid string, orgID int64) (*datasources.DataSource, error) {
 | 
						|
	query := datasources.GetDataSourceQuery{
 | 
						|
		UID:   uid,
 | 
						|
		OrgID: orgID,
 | 
						|
	}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(ctx, &query)
 | 
						|
	if err != nil {
 | 
						|
		return nil, err
 | 
						|
	}
 | 
						|
 | 
						|
	return dataSource, nil
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/name/{name} datasources getDataSourceByName
 | 
						|
//
 | 
						|
// Get a single data source by Name.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: getDataSourceResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) GetDataSourceByName(c *contextmodel.ReqContext) response.Response {
 | 
						|
	query := datasources.GetDataSourceQuery{Name: web.Params(c.Req)[":name"], OrgID: c.OrgID}
 | 
						|
 | 
						|
	dataSource, err := hs.DataSourcesService.GetDataSource(c.Req.Context(), &query)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to query datasources", err)
 | 
						|
	}
 | 
						|
 | 
						|
	dto := hs.convertModelToDtos(c.Req.Context(), dataSource)
 | 
						|
	return response.JSON(http.StatusOK, &dto)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/id/{name} datasources getDataSourceIdByName
 | 
						|
//
 | 
						|
// Get data source Id by Name.
 | 
						|
//
 | 
						|
// If you are running Grafana Enterprise and have Fine-grained access control enabled
 | 
						|
// you need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: getDataSourceIDResponse
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) GetDataSourceIdByName(c *contextmodel.ReqContext) response.Response {
 | 
						|
	query := datasources.GetDataSourceQuery{Name: web.Params(c.Req)[":name"], OrgID: c.OrgID}
 | 
						|
 | 
						|
	ds, err := hs.DataSourcesService.GetDataSource(c.Req.Context(), &query)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceNotFound) {
 | 
						|
			return response.Error(404, "Data source not found", nil)
 | 
						|
		}
 | 
						|
		return response.Error(500, "Failed to query datasources", err)
 | 
						|
	}
 | 
						|
 | 
						|
	dtos := dtos.AnyId{
 | 
						|
		Id: ds.ID,
 | 
						|
	}
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, &dtos)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/{id}/resources/{datasource_proxy_route} datasources callDatasourceResourceByID
 | 
						|
//
 | 
						|
// Fetch data source resources by Id.
 | 
						|
//
 | 
						|
// Please refer to [updated API](#/datasources/callDatasourceResourceWithUID) instead
 | 
						|
//
 | 
						|
// Deprecated: true
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) CallDatasourceResource(c *contextmodel.ReqContext) {
 | 
						|
	datasourceID, err := strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64)
 | 
						|
	if err != nil {
 | 
						|
		c.JsonApiErr(http.StatusBadRequest, "id is invalid", nil)
 | 
						|
		return
 | 
						|
	}
 | 
						|
	ds, err := hs.DataSourceCache.GetDatasource(c.Req.Context(), datasourceID, c.SignedInUser, c.SkipCache)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceAccessDenied) {
 | 
						|
			c.JsonApiErr(403, "Access denied to datasource", err)
 | 
						|
			return
 | 
						|
		}
 | 
						|
		c.JsonApiErr(500, "Unable to load datasource meta data", err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	plugin, exists := hs.pluginStore.Plugin(c.Req.Context(), ds.Type)
 | 
						|
	if !exists {
 | 
						|
		c.JsonApiErr(500, "Unable to find datasource plugin", err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	hs.callPluginResourceWithDataSource(c, plugin.ID, ds)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/uid/{uid}/resources/{datasource_proxy_route} datasources callDatasourceResourceWithUID
 | 
						|
//
 | 
						|
// Fetch data source resources.
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 404: notFoundError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) CallDatasourceResourceWithUID(c *contextmodel.ReqContext) {
 | 
						|
	dsUID := web.Params(c.Req)[":uid"]
 | 
						|
	if !util.IsValidShortUID(dsUID) {
 | 
						|
		c.JsonApiErr(http.StatusBadRequest, "UID is invalid", nil)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.DataSourceCache.GetDatasourceByUID(c.Req.Context(), dsUID, c.SignedInUser, c.SkipCache)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceAccessDenied) {
 | 
						|
			c.JsonApiErr(http.StatusForbidden, "Access denied to datasource", err)
 | 
						|
			return
 | 
						|
		}
 | 
						|
		c.JsonApiErr(http.StatusInternalServerError, "Unable to load datasource meta data", err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	plugin, exists := hs.pluginStore.Plugin(c.Req.Context(), ds.Type)
 | 
						|
	if !exists {
 | 
						|
		c.JsonApiErr(http.StatusInternalServerError, "Unable to find datasource plugin", err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	hs.callPluginResourceWithDataSource(c, plugin.ID, ds)
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) convertModelToDtos(ctx context.Context, ds *datasources.DataSource) dtos.DataSource {
 | 
						|
	dto := dtos.DataSource{
 | 
						|
		Id:               ds.ID,
 | 
						|
		UID:              ds.UID,
 | 
						|
		OrgId:            ds.OrgID,
 | 
						|
		Name:             ds.Name,
 | 
						|
		Url:              ds.URL,
 | 
						|
		Type:             ds.Type,
 | 
						|
		Access:           ds.Access,
 | 
						|
		Database:         ds.Database,
 | 
						|
		User:             ds.User,
 | 
						|
		BasicAuth:        ds.BasicAuth,
 | 
						|
		BasicAuthUser:    ds.BasicAuthUser,
 | 
						|
		WithCredentials:  ds.WithCredentials,
 | 
						|
		IsDefault:        ds.IsDefault,
 | 
						|
		JsonData:         ds.JsonData,
 | 
						|
		SecureJsonFields: map[string]bool{},
 | 
						|
		Version:          ds.Version,
 | 
						|
		ReadOnly:         ds.ReadOnly,
 | 
						|
	}
 | 
						|
 | 
						|
	secrets, err := hs.DataSourcesService.DecryptedValues(ctx, ds)
 | 
						|
	if err == nil {
 | 
						|
		for k, v := range secrets {
 | 
						|
			if len(v) > 0 {
 | 
						|
				dto.SecureJsonFields[k] = true
 | 
						|
			}
 | 
						|
		}
 | 
						|
	} else {
 | 
						|
		datasourcesLogger.Debug("Failed to retrieve datasource secrets to parse secure json fields", "error", err)
 | 
						|
	}
 | 
						|
 | 
						|
	return dto
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/uid/{uid}/health datasources checkDatasourceHealthWithUID
 | 
						|
//
 | 
						|
// Sends a health check request to the plugin datasource identified by the UID.
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) CheckDatasourceHealthWithUID(c *contextmodel.ReqContext) response.Response {
 | 
						|
	dsUID := web.Params(c.Req)[":uid"]
 | 
						|
	if !util.IsValidShortUID(dsUID) {
 | 
						|
		return response.Error(http.StatusBadRequest, "UID is invalid", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.DataSourceCache.GetDatasourceByUID(c.Req.Context(), dsUID, c.SignedInUser, c.SkipCache)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceAccessDenied) {
 | 
						|
			return response.Error(http.StatusForbidden, "Access denied to datasource", err)
 | 
						|
		}
 | 
						|
		return response.Error(http.StatusInternalServerError, "Unable to load datasource metadata", err)
 | 
						|
	}
 | 
						|
	return hs.checkDatasourceHealth(c, ds)
 | 
						|
}
 | 
						|
 | 
						|
// swagger:route GET /datasources/{id}/health datasources checkDatasourceHealthByID
 | 
						|
//
 | 
						|
// Sends a health check request to the plugin datasource identified by the ID.
 | 
						|
//
 | 
						|
// Please refer to [updated API](#/datasources/checkDatasourceHealthWithUID) instead
 | 
						|
//
 | 
						|
// Deprecated: true
 | 
						|
//
 | 
						|
// Responses:
 | 
						|
// 200: okResponse
 | 
						|
// 400: badRequestError
 | 
						|
// 401: unauthorisedError
 | 
						|
// 403: forbiddenError
 | 
						|
// 500: internalServerError
 | 
						|
func (hs *HTTPServer) CheckDatasourceHealth(c *contextmodel.ReqContext) response.Response {
 | 
						|
	datasourceID, err := strconv.ParseInt(web.Params(c.Req)[":id"], 10, 64)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(http.StatusBadRequest, "id is invalid", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	ds, err := hs.DataSourceCache.GetDatasource(c.Req.Context(), datasourceID, c.SignedInUser, c.SkipCache)
 | 
						|
	if err != nil {
 | 
						|
		if errors.Is(err, datasources.ErrDataSourceAccessDenied) {
 | 
						|
			return response.Error(http.StatusForbidden, "Access denied to datasource", err)
 | 
						|
		}
 | 
						|
		return response.Error(http.StatusInternalServerError, "Unable to load datasource metadata", err)
 | 
						|
	}
 | 
						|
	return hs.checkDatasourceHealth(c, ds)
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) checkDatasourceHealth(c *contextmodel.ReqContext, ds *datasources.DataSource) response.Response {
 | 
						|
	plugin, exists := hs.pluginStore.Plugin(c.Req.Context(), ds.Type)
 | 
						|
	if !exists {
 | 
						|
		return response.Error(http.StatusInternalServerError, "Unable to find datasource plugin", nil)
 | 
						|
	}
 | 
						|
 | 
						|
	dsInstanceSettings, err := adapters.ModelToInstanceSettings(ds, hs.decryptSecureJsonDataFn(c.Req.Context()))
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(http.StatusInternalServerError, "Unable to get datasource model", err)
 | 
						|
	}
 | 
						|
	req := &backend.CheckHealthRequest{
 | 
						|
		PluginContext: backend.PluginContext{
 | 
						|
			User:                       adapters.BackendUserFromSignedInUser(c.SignedInUser),
 | 
						|
			OrgID:                      c.OrgID,
 | 
						|
			PluginID:                   plugin.ID,
 | 
						|
			DataSourceInstanceSettings: dsInstanceSettings,
 | 
						|
		},
 | 
						|
		Headers: map[string]string{},
 | 
						|
	}
 | 
						|
 | 
						|
	var dsURL string
 | 
						|
	if req.PluginContext.DataSourceInstanceSettings != nil {
 | 
						|
		dsURL = req.PluginContext.DataSourceInstanceSettings.URL
 | 
						|
	}
 | 
						|
 | 
						|
	err = hs.PluginRequestValidator.Validate(dsURL, c.Req)
 | 
						|
	if err != nil {
 | 
						|
		return response.Error(http.StatusForbidden, "Access denied", err)
 | 
						|
	}
 | 
						|
 | 
						|
	resp, err := hs.pluginClient.CheckHealth(c.Req.Context(), req)
 | 
						|
	if err != nil {
 | 
						|
		return translatePluginRequestErrorToAPIError(err)
 | 
						|
	}
 | 
						|
 | 
						|
	payload := map[string]interface{}{
 | 
						|
		"status":  resp.Status.String(),
 | 
						|
		"message": resp.Message,
 | 
						|
	}
 | 
						|
 | 
						|
	// Unmarshal JSONDetails if it's not empty.
 | 
						|
	if len(resp.JSONDetails) > 0 {
 | 
						|
		var jsonDetails map[string]interface{}
 | 
						|
		err = json.Unmarshal(resp.JSONDetails, &jsonDetails)
 | 
						|
		if err != nil {
 | 
						|
			return response.Error(http.StatusInternalServerError, "Failed to unmarshal detailed response from backend plugin", err)
 | 
						|
		}
 | 
						|
 | 
						|
		payload["details"] = jsonDetails
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.Status != backend.HealthStatusOk {
 | 
						|
		return response.JSON(http.StatusBadRequest, payload)
 | 
						|
	}
 | 
						|
 | 
						|
	return response.JSON(http.StatusOK, payload)
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) decryptSecureJsonDataFn(ctx context.Context) func(ds *datasources.DataSource) (map[string]string, error) {
 | 
						|
	return func(ds *datasources.DataSource) (map[string]string, error) {
 | 
						|
		return hs.DataSourcesService.DecryptedValues(ctx, ds)
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func (hs *HTTPServer) filterDatasourcesByQueryPermission(ctx context.Context, user *user.SignedInUser, ds []*datasources.DataSource) ([]*datasources.DataSource, error) {
 | 
						|
	query := datasources.DatasourcesPermissionFilterQuery{
 | 
						|
		User:        user,
 | 
						|
		Datasources: ds,
 | 
						|
	}
 | 
						|
 | 
						|
	dataSources, err := hs.DatasourcePermissionsService.FilterDatasourcesBasedOnQueryPermissions(ctx, &query)
 | 
						|
	if err != nil {
 | 
						|
		if !errors.Is(err, permissions.ErrNotImplemented) {
 | 
						|
			return nil, err
 | 
						|
		}
 | 
						|
		return ds, nil
 | 
						|
	}
 | 
						|
 | 
						|
	return dataSources, nil
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters checkDatasourceHealthByID
 | 
						|
type CheckDatasourceHealthByIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceID string `json:"id"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters callDatasourceResourceByID
 | 
						|
type CallDatasourceResourceByIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceID string `json:"id"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters deleteDataSourceByID
 | 
						|
type DeleteDataSourceByIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceID string `json:"id"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters getDataSourceByID
 | 
						|
type GetDataSourceByIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceID string `json:"id"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters checkDatasourceHealthWithUID
 | 
						|
type CheckDatasourceHealthWithUIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceUID string `json:"uid"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters callDatasourceResourceWithUID
 | 
						|
type CallDatasourceResourceWithUIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceUID string `json:"uid"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters deleteDataSourceByUID
 | 
						|
type DeleteDataSourceByUIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceUID string `json:"uid"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters getDataSourceByUID
 | 
						|
type GetDataSourceByUIDParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceUID string `json:"uid"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters getDataSourceByName
 | 
						|
type GetDataSourceByNameParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceName string `json:"name"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters deleteDataSourceByName
 | 
						|
type DeleteDataSourceByNameParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceName string `json:"name"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters getDataSourceIdByName
 | 
						|
type GetDataSourceIdByNameParams struct {
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceName string `json:"name"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters addDataSource
 | 
						|
type AddDataSourceParams struct {
 | 
						|
	// in:body
 | 
						|
	// required:true
 | 
						|
	Body datasources.AddDataSourceCommand
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters updateDataSourceByID
 | 
						|
type UpdateDataSourceByIDParams struct {
 | 
						|
	// in:body
 | 
						|
	// required:true
 | 
						|
	Body datasources.UpdateDataSourceCommand
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceID string `json:"id"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:parameters updateDataSourceByUID
 | 
						|
type UpdateDataSourceByUIDParams struct {
 | 
						|
	// in:body
 | 
						|
	// required:true
 | 
						|
	Body datasources.UpdateDataSourceCommand
 | 
						|
	// in:path
 | 
						|
	// required:true
 | 
						|
	DatasourceUID string `json:"uid"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:response getDataSourcesResponse
 | 
						|
type GetDataSourcesResponse struct {
 | 
						|
	// The response message
 | 
						|
	// in: body
 | 
						|
	Body dtos.DataSourceList `json:"body"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:response getDataSourceResponse
 | 
						|
type GetDataSourceResponse struct {
 | 
						|
	// The response message
 | 
						|
	// in: body
 | 
						|
	Body dtos.DataSource `json:"body"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:response createOrUpdateDatasourceResponse
 | 
						|
type CreateOrUpdateDatasourceResponse struct {
 | 
						|
	// The response message
 | 
						|
	// in: body
 | 
						|
	Body struct {
 | 
						|
		// ID Identifier of the new data source.
 | 
						|
		// required: true
 | 
						|
		// example: 65
 | 
						|
		ID int64 `json:"id"`
 | 
						|
 | 
						|
		// Name of the new data source.
 | 
						|
		// required: true
 | 
						|
		// example: My Data source
 | 
						|
		Name string `json:"name"`
 | 
						|
 | 
						|
		// Message Message of the deleted dashboard.
 | 
						|
		// required: true
 | 
						|
		// example: Data source added
 | 
						|
		Message string `json:"message"`
 | 
						|
 | 
						|
		// Datasource properties
 | 
						|
		// required: true
 | 
						|
		Datasource dtos.DataSource `json:"datasource"`
 | 
						|
	} `json:"body"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:response getDataSourceIDResponse
 | 
						|
type GetDataSourceIDresponse struct {
 | 
						|
	// The response message
 | 
						|
	// in: body
 | 
						|
	Body struct {
 | 
						|
		// ID Identifier of the data source.
 | 
						|
		// required: true
 | 
						|
		// example: 65
 | 
						|
		ID int64 `json:"id"`
 | 
						|
	} `json:"body"`
 | 
						|
}
 | 
						|
 | 
						|
// swagger:response deleteDataSourceByNameResponse
 | 
						|
type DeleteDataSourceByNameResponse struct {
 | 
						|
	// The response message
 | 
						|
	// in: body
 | 
						|
	Body struct {
 | 
						|
		// ID Identifier of the deleted data source.
 | 
						|
		// required: true
 | 
						|
		// example: 65
 | 
						|
		ID int64 `json:"id"`
 | 
						|
 | 
						|
		// Message Message of the deleted dashboard.
 | 
						|
		// required: true
 | 
						|
		// example: Dashboard My Dashboard deleted
 | 
						|
		Message string `json:"message"`
 | 
						|
	} `json:"body"`
 | 
						|
}
 |