GET /topics/{string: topic_name}
Retrieves metadata about a specific topic.
Description
Depending on the configuration, the type of information retrieved has different behavior.
See the streams.default.stream
in Configuration Parameters
Parameters Defined | Response |
---|---|
streams.default.stream is defined | Gets metadata about a specific HPE Ezmeral Data Fabric Streams topic. A fully qualified topic name can be passed or not. If the topic name is not fully qualified, the metadata is retrieved and appended to the default stream path. For example, topic1 is equivalent to default_stream:topic1 |
streams.default.stream is not defined | Gets metadata about a specific HPE Ezmeral Data Fabric Streams topic. A fully qualified topic name is passed that contains the stream path. |
NOTE
The full name for the HPE Ezmeral Data Fabric Streams topic contains characters such as a forward slash (/)
and a colon (:), therefore, it should be encoded. For example,
/streaming_data/stream:topic-1
is equivalent to
%2Fstreaming_data%2Fstream%3Atopic-1
.Parameters | Description |
---|---|
topic_name (string) | Name of the topic to get metadata about. |
Syntax
Syntax for a topic in a default stream where the default stream is configured:
http://<host>:8082/topics/<topic_string>
Syntax for a topic where the fully qualified topic name is specified:
http://<host>:8082/topics/%2F<streaming_data>%2F<stream>%3A<topic1>
Request Example
curl "http://localhost:8082/topics/test"
Response Example
{
"name":"test",
"configs":null,
"partitions":
[
{
"partition":0,
"leader":0,
"replicas":
[
{"broker":0,"leader":true, "in_sync":true},
{"broker":0,"leader":false, "in_sync":true}
]
}
]
}