DescribeConnector - Amazon MSK Connect

DescribeConnector

Returns summary information about the connector.

Request Syntax

GET /v1/connectors/connectorArn HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

connectorArn

The Amazon Resource Name (ARN) of the connector that you want to describe.

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "capacity": { "autoScaling": { "maxWorkerCount": number, "mcuCount": number, "minWorkerCount": number, "scaleInPolicy": { "cpuUtilizationPercentage": number }, "scaleOutPolicy": { "cpuUtilizationPercentage": number } }, "provisionedCapacity": { "mcuCount": number, "workerCount": number } }, "connectorArn": "string", "connectorConfiguration": { "string" : "string" }, "connectorDescription": "string", "connectorName": "string", "connectorState": "string", "creationTime": "string", "currentVersion": "string", "kafkaCluster": { "apacheKafkaCluster": { "bootstrapServers": "string", "vpc": { "securityGroups": [ "string" ], "subnets": [ "string" ] } } }, "kafkaClusterClientAuthentication": { "authenticationType": "string" }, "kafkaClusterEncryptionInTransit": { "encryptionType": "string" }, "kafkaConnectVersion": "string", "logDelivery": { "workerLogDelivery": { "cloudWatchLogs": { "enabled": boolean, "logGroup": "string" }, "firehose": { "deliveryStream": "string", "enabled": boolean }, "s3": { "bucket": "string", "enabled": boolean, "prefix": "string" } } }, "plugins": [ { "customPlugin": { "customPluginArn": "string", "revision": number } } ], "serviceExecutionRoleArn": "string", "stateDescription": { "code": "string", "message": "string" }, "workerConfiguration": { "revision": number, "workerConfigurationArn": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

capacity

Information about the capacity of the connector, whether it is auto scaled or provisioned.

Type: CapacityDescription object

connectorArn

The Amazon Resource Name (ARN) of the connector.

Type: String

connectorConfiguration

A map of keys to values that represent the configuration for the connector.

Type: String to string map

connectorDescription

A summary description of the connector.

Type: String

connectorName

The name of the connector.

Type: String

connectorState

The state of the connector.

Type: String

Valid Values: RUNNING | CREATING | UPDATING | DELETING | FAILED

creationTime

The time the connector was created.

Type: Timestamp

currentVersion

The current version of the connector.

Type: String

kafkaCluster

The Apache Kafka cluster that the connector is connected to.

Type: KafkaClusterDescription object

kafkaClusterClientAuthentication

The type of client authentication used to connect to the Apache Kafka cluster. The value is NONE when no client authentication is used.

Type: KafkaClusterClientAuthenticationDescription object

kafkaClusterEncryptionInTransit

Details of encryption in transit to the Apache Kafka cluster.

Type: KafkaClusterEncryptionInTransitDescription object

kafkaConnectVersion

The version of Kafka Connect. It has to be compatible with both the Apache Kafka cluster's version and the plugins.

Type: String

logDelivery

Details about delivering logs to Amazon CloudWatch Logs.

Type: LogDeliveryDescription object

plugins

Specifies which plugins were used for this connector.

Type: Array of PluginDescription objects

serviceExecutionRoleArn

The Amazon Resource Name (ARN) of the IAM role used by the connector to access Amazon Web Services resources.

Type: String

stateDescription

Details about the state of a connector.

Type: StateDescription object

workerConfiguration

Specifies which worker configuration was used for the connector.

Type: WorkerConfigurationDescription object

Errors

For information about the errors that are common to all actions, see Common Errors.

BadRequestException

HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it.

HTTP Status Code: 400

ForbiddenException

HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request.

HTTP Status Code: 403

InternalServerErrorException

HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue.

HTTP Status Code: 500

NotFoundException

HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it.

HTTP Status Code: 404

ServiceUnavailableException

HTTP Status Code 503: Service Unavailable. Retrying your request in some time might resolve the issue.

HTTP Status Code: 503

TooManyRequestsException

HTTP Status Code 429: Limit exceeded. Resource limit reached.

HTTP Status Code: 429

UnauthorizedException

HTTP Status Code 401: Unauthorized request. The provided credentials couldn't be validated.

HTTP Status Code: 401

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: