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

Retrieves a list of replicas 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 replicas 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 replicas 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.

Syntax

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

Request Example

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

Response Example

{
  "kind":"KafkaReplicaList",
  "metadata":
    {
      "self":"http://node1.cluster.com:8082/v3/clusters/682798077049224619/topics/tp-2/partitions/1/replicas",
      "next":null
    },
  "data":
    [
        {
          "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"
            }
        }
    ]
}