GET /v3/clusters/{string: cluster_id}/topics/{string: topic_name}/partitions/{string: partition_id}/replicas/{string: broker_id}

Retrieves metadata about a specific replica within a partition, a topic, and a cluster.

Description

The behavior of the information retrieved depends on the configuration. See streams.default.stream in Configuration Parameters.
Table 1. Response Behavior
Parameters Defined Response
streams.default.stream is defined Gets metadata about specific broker of the HPE Ezmeral Data Fabric Streams partition within a topic. You can pass a fully qualified topic name or not. If a fully qualified topic name is not used, metadata is retrieved and appended to the default stream path.
streams.default.stream is not defined Gets metadata about specific broker of the HPE Ezmeral Data Fabric Streams partition within a topic. The user could only pass fully qualified topic name that contains stream path.
Table 2. Parameters
Parameters Description
cluster_id (string) Cluster’s id.
topic_name (string) Name of the topic.
partition_id (int) ID of the partition to inspect.
broker_id (int) ID of the broker to inspect.

Syntax

http://<host>:8082/v3/clusters/<cluster_id>/topics/<topic_name>/partitions/<partition_id>/replicas/<broker_id>

Request Example

$ curl -X GET -H "Content-Type: application/json" "http://localhost:8082/v3/clusters/682798077049224619/topics/tp-2/partitions/1/replicas/0"

Response Example

{
  "kind":"KafkaReplica",
  "metadata":
    {
      "self":"http://node1.cluster.com:8082/v3/clusters/682798077049224619/topics/str:tp-2/partitions/1/replicas/0",
      "resource_name":"crn:///kafka=682798077049224619/topic=str:tp-2/partition=1/replica=0"
    },
  "cluster_id":"682798077049224619",
  "topic_name":"/str:tp-2",
  "partition_id":1,
  "broker_id":0,
  "is_leader":true,
  "is_in_sync":true,
  "broker":
    {
      "related":"http://node1.cluster.com:8082/v3/clusters/682798077049224619/brokers/0"
    }
}