[META][AppEx - AnalyticsXP] Version all HTTP routes

[thomasneirynck]

Summary

All HTTP routes need versioning.

Concretely, following changes need to be made:

• on-board on new kibana router
• if the route exposes saved-objects, decouple storage-model from http-model (this is a pro-forma change. A soft 1:1 relationship is expected for initial releases)
• adopt versioning scheme
  • public routes need to follow date-based versioning scheme
  • internal routes can use ad-hoc versioning

Route list

Below is an exhausitve list of all internal and external routes.

Search

• /internal/bsearch
• /internal/search/{strategy}/**

File upload

• /internal/file_upload/import
• /internal/file_upload/index_exists
• /internal/file_upload/time_field_range

Dashboards

• /internal/dashboards
• /api/kibana/dashboards/export (owned by Core)
• /api/kibana/dashboards/import (owned by Core)

Data views

• /internal/data_views/has_data_views
• /api/data_views
• /api/data_views/data_view
• /api/data_views/data_view/**
• /api/data_views/default
• /api/data_views/has_user_data_view

Canvas

• /public/canvas/zip
• /api/canvas/custom-element/**
• /api/canvas/es_fields Removed
• /api/canvas/fns/
• /api/canvas/templates
• /api/canvas/workpad
• /api/canvas/workpad-assets
• /api/canvas/workpad-structures
• /api/canvas/workpad
• /api/canvas/workpad/{id}
• /api/canvas/workpad/find
• /api/canvas/workpad/import
• /api/canvas/workpad/resolve/{id}

Graph

• /api/graph/graphExplore
• /api/graph/searchProxy

Controls

• /api/kibana/controls/optionsList/{index}
• /api/kibana/controls/optionsList/getClusterSettings

Maps

• /api/maps/checkIsDrawingIndex
• /api/maps/docSource
• /api/maps
• /api/maps/feature/{featureId}
• /api/maps/fonts/{fontstack}/{range}
• /api/maps/getMatchingIndexes
• /api/maps/indexSettings
• /api/maps/mvt/getGridTile/{z}/{x}/{y}.pbf
• /api/maps/mvt/getTile/{z}/{x}/{y}.pbf

Saved query

• /api/saved_query/**

Timelion

• /api/timelion/functions
• /api/timelion/run

Index pattern

• /internal/index-pattern-management/preview_scripted_field
• /internal/index-pattern-management/resolve_index/{query}
• /api/index_pattern_field_editor/**
• /api/index_patterns/_fields_for_wildcard
• /api/index_patterns/default
• /api/index_patterns/has_user_index_pattern
• /api/index_patterns/index_pattern/**

Unified Field List

• /api/unified_field_list/existing_fields/{dataViewId}
• /api/unified_field_list/field_stats

[elasticmachine]

Pinging @elastic/kibana-presentation (Team:Presentation)

[elasticmachine]

Pinging @elastic/kibana-visualizations @elastic/kibana-visualizations-external (Team:Visualizations)

[elasticmachine]

Pinging @elastic/kibana-data-discovery (Team:DataDiscovery)

[logeekal]

@thomasneirynck , I am trying to learn more about how we are versioning our app, so is it possible to include the original versioning design linked in the PR? It will help to get background on that. Thanks.

[thomasneirynck]

Completed