AppConfigData / Client / start_configuration_session



Starts a configuration session used to retrieve a deployed configuration. For more information about this API action and to view example CLI commands that show how to use it with the GetLatestConfiguration API action, see Retrieving the configuration in the AppConfig User Guide.

See also: AWS API Documentation

Request Syntax

response = client.start_configuration_session(
  • ApplicationIdentifier (string) –


    The application ID or the application name.

  • EnvironmentIdentifier (string) –


    The environment ID or the environment name.

  • ConfigurationProfileIdentifier (string) –


    The configuration profile ID or the configuration profile name.

  • RequiredMinimumPollIntervalInSeconds (integer) – Sets a constraint on a session. If you specify a value of, for example, 60 seconds, then the client that established the session can’t call GetLatestConfiguration more frequently than every 60 seconds.

Return type:



Response Syntax

    'InitialConfigurationToken': 'string'

Response Structure

  • (dict) –

    • InitialConfigurationToken (string) –

      Token encapsulating state about the configuration session. Provide this token to the GetLatestConfiguration API to retrieve configuration data.


      This token should only be used once in your first call to GetLatestConfiguration. You must use the new token in the GetLatestConfiguration response ( NextPollConfigurationToken) in each subsequent call to GetLatestConfiguration.

      The InitialConfigurationToken and NextPollConfigurationToken should only be used once. To support long poll use cases, the tokens are valid for up to 24 hours. If a GetLatestConfiguration call uses an expired token, the system returns BadRequestException.


  • AppConfigData.Client.exceptions.ThrottlingException

  • AppConfigData.Client.exceptions.ResourceNotFoundException

  • AppConfigData.Client.exceptions.BadRequestException

  • AppConfigData.Client.exceptions.InternalServerException