URI HTTP methods Schemas Properties See also

Topic

URI

/v1/clusters/clusterArn/topics/topicName

HTTP methods

GET

Operation ID: DescribeTopic

Returns details for a topic on a cluster.

This API response reflects data that updates approximately every minute. For the most current topic state after making changes, allow approximately one minute before querying.

Path parameters
Name	Type	Required	Description
`clusterArn`	String	True	The Amazon Resource Name (ARN) that uniquely identifies the cluster.
`topicName`	String	True	The name of the topic.

Responses
Status code	Response model	Description
`200`	`DescribeTopicResponse`	Successful response.
`400`	`Error`	The request isn't valid because the input is incorrect. Correct your input and then submit it again.
`401`	`Error`	The request is not authorized. The provided credentials couldn't be validated.
`403`	`Error`	Access forbidden. Check your credentials and then retry your request.
`404`	`Error`	The resource could not be found due to incorrect input. Correct the input, then retry the request.
`429`	`Error`	429 response
`500`	`Error`	There was an unexpected internal server error. Retrying your request might resolve the issue.
`503`	`Error`	503 response

Schemas

Response bodies


{
  "replicationFactor": number,
  "partitionCount": number,
  "configs": "string",
  "topicName": "string",
  "topicArn": "string",
  "status": enum
}


{
  "message": "string",
  "invalidParameter": "string"
}

Properties

DescribeTopicResponse

The response contains metadata for a topic on a cluster.

Property	Type	Required	Description
`configs`	string	False	Kafka configs for a topic.
`partitionCount`	number	False	Partition count for a topic
`replicationFactor`	number	False	Replication factor for a topic
`status`	TopicStatus	False	Status of the topic.
`topicArn`	string	False	ARN of the topic.
`topicName`	string	False	Name for a topic.

Error

Returns information about an error.

Property	Type	Required	Description
`invalidParameter`	string	False	The parameter that caused the error.
`message`	string	False	The description of the error.

TopicStatus

Status of a kafka topic

CREATING
UPDATING
DELETING
ACTIVE