URI HTTP methods Schemas Properties See also

Configuration Revisions

Represents the revisions of an MSK configuration.

URI

/v1/configurations/arn/revisions

HTTP methods

GET

Operation ID: ListConfigurationRevisions

Returns a list of all the revisions of an MSK configuration.

Path parameters
Name	Type	Required	Description
`arn`	String	True	The Amazon Resource Name (ARN) that uniquely identifies an MSK configuration and all of its revisions.

Query parameters
Name	Type	Required	Description
`nextToken`	String	False	The paginated results marker. When the result of the operation is truncated, the call returns `NextToken` in the response. To get the next batch, provide this token in your next request.
`maxResults`	String	False	The maximum number of results to return in the response (default maximum 100 results per API call). If there are more results, the response includes a `NextToken` parameter.

Responses
Status code	Response model	Description
`200`	`ListConfigurationRevisionsResponse`	200 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

OPTIONS

Enable CORS by returning the correct headers.

Path parameters
Name	Type	Required	Description
`arn`	String	True	The Amazon Resource Name (ARN) that uniquely identifies an MSK configuration and all of its revisions.

Responses
Status code	Response model	Description
`200`	None	Default response for CORS method

Schemas

Response bodies


{
  "nextToken": "string",
  "revisions": [
    {
      "creationTime": "string",
      "description": "string",
      "revision": integer
    }
  ]
}


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

Properties

ConfigurationRevision

Describes a configuration revision.

Property Type Required Description

Property	Type	Required	Description
`creationTime`	string	True	The time when the configuration revision was created.
`description`	string	False	The description of the configuration revision.
`revision`	integer Format: int64	True	The revision number.

creationTime

string

True

The time when the configuration revision was created.

description

string

False

The description of the configuration revision.

revision

integer

Format: int64

True

The revision number.

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.

ListConfigurationRevisionsResponse

Information about revisions of an MSK configuration.

Property	Type	Required	Description
`nextToken`	string	False	Paginated results marker.
`revisions`	Array of type ConfigurationRevision	False	List of ConfigurationRevision objects.