Retrieve cluster details | Qdrant

{
  "usage": {
    "cpu": 1,
    "io_read": 1,
    "io_write": 1
  },
  "time": 0.002,
  "status": "ok",
  "result": {
    "peer_id": 1,
    "shard_count": 1,
    "local_shards": [
      {
        "shard_id": 1,
        "points_count": 1,
        "state": "Active",
        "shard_key": "region_1"
      }
    ],
    "remote_shards": [
      {
        "shard_id": 1,
        "peer_id": 1,
        "state": "Active",
        "shard_key": "region_1"
      }
    ],
    "shard_transfers": [
      {
        "shard_id": 1,
        "from": 1,
        "to": 1,
        "sync": true,
        "to_shard_id": 1,
        "method": "stream_records",
        "comment": "string"
      }
    ],
    "resharding_operations": [
      {
        "direction": "up",
        "shard_id": 1,
        "peer_id": 1,
        "shard_key": "region_1"
      }
    ]
  }
}

Retrieves cluster details for a specified collection.

Authentication

api-keystring

API Key authentication via header

Path parameters

collection_namestringRequired

Name of the collection to retrieve the cluster info for

Response

successful operation

usageobject or anyOptional

timedoubleOptional

Time spent to process this request

statusstringOptional

resultobjectOptional

Current clustering distribution for the collection

1	{
2	"usage": {
3	"cpu": 1,
4	"io_read": 1,
5	"io_write": 1
6	},
7	"time": 0.002,
8	"status": "ok",
9	"result": {
10	"peer_id": 1,
11	"shard_count": 1,
12	"local_shards": [
13	{
14	"shard_id": 1,
15	"points_count": 1,
16	"state": "Active",
17	"shard_key": "region_1"
18	}
19	],
20	"remote_shards": [
21	{
22	"shard_id": 1,
23	"peer_id": 1,
24	"state": "Active",
25	"shard_key": "region_1"
26	}
27	],
28	"shard_transfers": [
29	{
30	"shard_id": 1,
31	"from": 1,
32	"to": 1,
33	"sync": true,
34	"to_shard_id": 1,
35	"method": "stream_records",
36	"comment": "string"
37	}
38	],
39	"resharding_operations": [
40	{
41	"direction": "up",
42	"shard_id": 1,
43	"peer_id": 1,
44	"shard_key": "region_1"
45	}
46	]
47	}
48	}

$	curl http://localhost:6333/collections/collection_name/cluster \
>	-H "api-key: <apiKey>"