Note

This documentation is for a prior release of Kinetica. For the latest documentation, click here.

/admin/show/shards

URL: https://<aws.fqdn>/<aws.cluster.name>/gpudb-0/admin/show/shards

Show the mapping of shards to the corresponding rank and tom. The response message contains list of 16384 (total number of shards in the system) Rank and TOM numbers corresponding to each shard.

Input Parameter Description

Name	Type	Description
options	map of string to strings	Optional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

Name

Type

Description

status

String

'OK' or 'ERROR'

message

String

Empty if success or an error message

data_type

String

'admin_show_shards_response' or 'none' in case of an error

data

String

Empty string

data_str

JSON or String

This embedded JSON represents the result of the /admin/show/shards endpoint:

Name	Type	Description
version	long	Current shard array version number.
rank	array of ints	Array of ranks indexed by the shard number.
tom	array of ints	Array of toms to which the corresponding shard belongs.
info	map of string to strings	Additional information.

Empty string in case of an error.