Kafka / Client / create_configuration

create_configuration#

Kafka.Client.create_configuration(**kwargs)#

Creates a new MSK configuration.

See also: AWS API Documentation

Request Syntax

response = client.create_configuration(
    Description='string',
    KafkaVersions=[
        'string',
    ],
    Name='string',
    ServerProperties=b'bytes'
)
Parameters:

  • Description (string) – The description of the configuration.

  • KafkaVersions (list) –

    The versions of Apache Kafka with which you can use this MSK configuration.

    • (string) –

  • Name (string) –

    [REQUIRED]

    The name of the configuration.

  • ServerProperties (bytes) –

    [REQUIRED]

    Contents of the server.properties file. When using the API, you must ensure that the contents of the file are base64 encoded. When using the AWS Management Console, the SDK, or the AWS CLI, the contents of server.properties can be in plaintext.

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'LatestRevision': {
        'CreationTime': datetime(2015, 1, 1),
        'Description': 'string',
        'Revision': 123
    },
    'Name': 'string',
    'State': 'ACTIVE'|'DELETING'|'DELETE_FAILED'
}

Response Structure

  • (dict) –

    200 response

    • Arn (string) –

      The Amazon Resource Name (ARN) of the configuration.

    • CreationTime (datetime) –

      The time when the configuration was created.

    • LatestRevision (dict) –

      Latest revision of the configuration.

      • CreationTime (datetime) –

        The time when the configuration revision was created.

      • Description (string) –

        The description of the configuration revision.

      • Revision (integer) –

        The revision number.

    • Name (string) –

      The name of the configuration.

    • State (string) –

      The state of the configuration. The possible states are ACTIVE, DELETING, and DELETE_FAILED.

Exceptions

  • Kafka.Client.exceptions.BadRequestException

  • Kafka.Client.exceptions.InternalServerErrorException

  • Kafka.Client.exceptions.UnauthorizedException

  • Kafka.Client.exceptions.ForbiddenException

  • Kafka.Client.exceptions.ServiceUnavailableException

  • Kafka.Client.exceptions.TooManyRequestsException

  • Kafka.Client.exceptions.ConflictException