:doc:`Kafka <../../kafka>` / Client / create_configuration

********************
create_configuration
********************



.. py:method:: Kafka.Client.create_configuration(**kwargs)

  

  Creates a new MSK configuration.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/CreateConfiguration>`_  


  **Request Syntax**
  ::

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

    The description of the configuration.

    

  
  :type KafkaVersions: list
  :param KafkaVersions: 

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

    

  
    - *(string) --* 

    

  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the configuration.

    

  
  :type ServerProperties: bytes
  :param ServerProperties: **[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.

    

  
  
  :rtype: 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**
  
  *   :py:class:`Kafka.Client.exceptions.BadRequestException`

  
  *   :py:class:`Kafka.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`Kafka.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`Kafka.Client.exceptions.ForbiddenException`

  
  *   :py:class:`Kafka.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`Kafka.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`Kafka.Client.exceptions.ConflictException`

  