ListBrokers

POST /redpanda.core.admin.v2.BrokerService/ListBrokers

Returns information about all brokers in the cluster.

Headers

  • Connect-Protocol-Version number Required

    Define the version of the Connect protocol

    Value is 1.

  • Connect-Timeout-Ms number

    Define the timeout, in ms

application/json

Body Required

object object

ListBrokersRequest returns information about all the brokers in the cluster

Additional properties are NOT allowed.

Responses

  • 200 application/json

    Success

    Hide response attribute Show response attribute object
    • brokers array[object]

      The brokers in the cluster and their information.

      The resource for an individual broker within the Kafka Cluster.

      Hide brokers attributes Show brokers attributes object
      • adminServer object

        AdminServer has information about the admin server within the broker.

        Additional properties are NOT allowed.

        Hide adminServer attribute Show adminServer attribute object
        • routes array[object]

          All of the ConnectRPC routes available on this admin server.

          A route in the Admin API RPC server.

          Hide routes attributes Show routes attributes object
          • httpRoute string

            The HTTP route for this RPC method.

            For example /redpanda.core.admin.v2.AdminService/GetVersion

          • name string

            The name of the RPC method.

            For example redpanda.core.admin.v2.AdminService.GetVersion

      • buildInfo object

        BuildInfo contains information about the Redpanda build.

        Additional properties are NOT allowed.

        Hide buildInfo attributes Show buildInfo attributes object
        • buildSha string

          The git commit SHA of the build.

        • version string

          A version string of Redpanda like "v25.2.1"

      • nodeId integer(int32)

        This broker's node ID.

  • default application/json

    Error

    Hide response attributes Show response attributes object
    • code string

      The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

      Values are canceled, unknown, invalid_argument, deadline_exceeded, not_found, already_exists, permission_denied, resource_exhausted, failed_precondition, aborted, out_of_range, unimplemented, internal, unavailable, data_loss, or unauthenticated.

    • details array[object]

      A list of messages that carry the error details. There is no limit on the number of messages.

      Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details.

      Hide details attributes Show details attributes object
      • debug object

        Detailed error information.

        Additional properties are allowed.

      • type string

        A URL that acts as a globally unique identifier for the type of the serialized message. For example: type.googleapis.com/google.rpc.ErrorInfo. This is used to determine the schema of the data in the value field and is the discriminator for the debug field.

      • value string(binary)

        The Protobuf message, serialized as bytes and base64-encoded. The specific message type is identified by the type field.

    • message string

      A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

POST /redpanda.core.admin.v2.BrokerService/ListBrokers
curl \
 --request POST 'http://localhost:9644/redpanda.core.admin.v2.BrokerService/ListBrokers' \
 --header "Content-Type: application/json" \
 --header "Connect-Protocol-Version: 1" \
 --header "Connect-Timeout-Ms: 42.0"
Request examples
# Headers
Connect-Protocol-Version: 1
Connect-Timeout-Ms: 42.0

# Payload
{}
Response examples (200)
{
  "brokers": [
    {
      "adminServer": {
        "routes": [
          {
            "httpRoute": "string",
            "name": "string"
          }
        ]
      },
      "buildInfo": {
        "buildSha": "string",
        "version": "string"
      },
      "nodeId": 42
    }
  ]
}
Response examples (default)
{
  "code": "not_found",
  "details": [
    {
      "debug": {},
      "type": "string",
      "value": "@file"
    }
  ],
  "message": "string"
}