Skip to main content
Version: Latest-3.5

HTTP Interface

To facilitate the maintenance of StarRocks clusters, StarRocks provides various types of operation and query interfaces. This topic introduces these HTTP interfaces and their usage.

FE​

Request MethodRequest PathDescription
PUT/api/{db}/{table}/_stream_loadStream Load operation, see Stream Load for details.
POST/PUT/api/transaction/{txn_op}Stream Load transaction interface, see Stream Load Transaction Interface for details.
GET/api/{db}/_load_info
GET/api/_set_config?config_key1=config_value1Update FE configuration.
GET/api/_get_ddl?db={}&tbl={}View table DDL statement.
GET/api/_migration?db={}&tbl={}View table tablet information.
GET/api/_check_storagetype
POST/api/{db}/{table}/_cancel?label={}
GET/api/{db}/get_load_state
GET/api/health
GET/metrics?type={core/json}View metrics of the current FE.
GET/api/show_meta_info
GET/api/show_proc
GET/api/show_runtime_info
HEAD/GET/api/get_log_file
GET/api/get_small_file
GET/api/rowcount
GET/api/check_decommission
GET/api/_meta_replay_state
POST/api/colocate/bucketseq
GET/api/colocate
POST/api/colocate/group_stable
POST/api/colocate/group_unstable
POST/api/colocate/update_group
POST/api/global_dict/table/enable
GET/api/profile?query_id={}Get profile information for the specified query ID.
GET/api/query_detail
GET/api/connection
GET/api/show_data?db={}Query the size of the specified database.
POST/api/query_dumpGet query dump information, see Query Dump for details.
GET/api/stop
GET/image
GET/info
GET/version
GET/put
GET/journal_id
GET/check
GET/dump
GET/role
GET/api/{db}/{table}/_count
GET/api/{db}/{table}/_schemaView table schema.
GET/POST/api/{db}/{table}/_query_plan

BE​

HTTP Request MethodHTTP Request PathDescription
PUT/api/{db}/{table}/_stream_loadStream Load operation, see Stream Load for details.
POST/PUT/api/transaction/{txn_op}Stream Load transaction interface, see Stream Load Transaction Interface for details.
PUT/api/transaction/load
HEAD/GET/api/_download_load
HEAD/GET/api/_tablet/_download
HEAD/GET/api/_load_error_log
GET/api/health
GET/api/_stop_be
GET/pprof/heap
GET/pprof/growth
GET/pprof/profile
GET/pprof/pmuprofile
GET/pprof/contention
GET/pprof/cmdline
HEAD/GET/POST/pprof/symbol
GET/metricsView metrics of the current BE.
HEAD/api/meta/header/{tablet_id}
GET/api/checksum
GET/api/reload_tablet
POST/api/restore_tablet
GET/api/snapshot
GET/api/compaction/show?tablet_id={}View compaction information for the specified tablet.
POST/api/compact?tablet_id={}&compaction_type={base/cumulative}Manually perform compaction on the specified tablet.
GET/api/compaction/show_repair
PUT/api/compaction/submit_repair
POST/api/update_configUpdate BE configuration, see Update BE Configuration for details.
GET/PUT/api/runtime_filter_cache/{action}
POST/api/compact_rocksdb_meta
GET/PUT/api/query_cache/{action}
GET/api/pipeline_blocking_drivers/{action}
GET/greplog
GET/varzView current BE configuration.

CN​

Request MethodRequest PathDescription
GET/api/health
GET/pprof/heap
GET/pprof/growth
GET/pprof/profile
GET/pprof/pmuprofile
GET/pprof/contention
GET/pprof/cmdline
HEAD/GET/POST/pprof/symbol
GET/metricsView metrics of the current CN.