AppConfig

Table of Contents

Client

class AppConfig.Client

A low-level client representing Amazon AppConfig:

import boto3

client = boto3.client('appconfig')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_application(**kwargs)

An application in AppConfig is a logical unit of code that provides capabilities for your customers. For example, an application can be a microservice that runs on Amazon EC2 instances, a mobile application installed by your users, a serverless application using Amazon API Gateway and AWS Lambda, or any system you run on behalf of others.

See also: AWS API Documentation

Request Syntax

response = client.create_application(
    Name='string',
    Description='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • Name (string) --

    [REQUIRED]

    A name for the application.

  • Description (string) -- A description of the application.
  • Tags (dict) --

    Metadata to assign to the application. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string'
}

Response Structure

  • (dict) --

    • Id (string) --

      The application ID.

    • Name (string) --

      The application name.

    • Description (string) --

      The description of the application.

create_configuration_profile(**kwargs)

Information that enables AppConfig to access the configuration source. Valid configuration sources include Systems Manager (SSM) documents and SSM Parameter Store parameters. A configuration profile includes the following information.

  • The Uri location of the configuration data.
  • The AWS Identity and Access Management (IAM) role that provides access to the configuration data.
  • A validator for the configuration data. Available validators include either a JSON Schema or an AWS Lambda function.

See also: AWS API Documentation

Request Syntax

response = client.create_configuration_profile(
    ApplicationId='string',
    Name='string',
    Description='string',
    LocationUri='string',
    RetrievalRoleArn='string',
    Validators=[
        {
            'Type': 'JSON_SCHEMA'|'LAMBDA',
            'Content': 'string'
        },
    ],
    Tags={
        'string': 'string'
    }
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • Name (string) --

    [REQUIRED]

    A name for the configuration profile.

  • Description (string) -- A description of the configuration profile.
  • LocationUri (string) --

    [REQUIRED]

    A URI to locate the configuration. You can specify either a Systems Manager (SSM) document or an SSM Parameter Store parameter. For an SSM document, specify either the document name in the format ssm-document://<Document name> or the Amazon Resource Name (ARN). For a parameter, specify either the parameter name in the format ssm-parameter://<Parameter name> or the ARN.

  • RetrievalRoleArn (string) --

    [REQUIRED]

    The ARN of an IAM role with permission to access the configuration at the specified LocationUri.

  • Validators (list) --

    A list of methods for validating the configuration.

    • (dict) --

      A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.

      • Type (string) -- [REQUIRED]

        AppConfig supports validators of type JSON_SCHEMA and LAMBDA

      • Content (string) -- [REQUIRED]

        Either the JSON Schema content or an AWS Lambda function name.

  • Tags (dict) --

    Metadata to assign to the configuration profile. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'LocationUri': 'string',
    'RetrievalRoleArn': 'string',
    'Validators': [
        {
            'Type': 'JSON_SCHEMA'|'LAMBDA',
            'Content': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The configuration profile ID.

    • Name (string) --

      The name of the configuration profile.

    • Description (string) --

      The configuration profile description.

    • LocationUri (string) --

      The URI location of the configuration.

    • RetrievalRoleArn (string) --

      The ARN of an IAM role with permission to access the configuration at the specified LocationUri.

    • Validators (list) --

      A list of methods for validating the configuration.

      • (dict) --

        A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.

        • Type (string) --

          AppConfig supports validators of type JSON_SCHEMA and LAMBDA

        • Content (string) --

          Either the JSON Schema content or an AWS Lambda function name.

create_deployment_strategy(**kwargs)

A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.

See also: AWS API Documentation

Request Syntax

response = client.create_deployment_strategy(
    Name='string',
    Description='string',
    DeploymentDurationInMinutes=123,
    FinalBakeTimeInMinutes=123,
    GrowthFactor=...,
    GrowthType='LINEAR',
    ReplicateTo='NONE'|'SSM_DOCUMENT',
    Tags={
        'string': 'string'
    }
)
Parameters
  • Name (string) --

    [REQUIRED]

    A name for the deployment strategy.

  • Description (string) -- A description of the deployment strategy.
  • DeploymentDurationInMinutes (integer) --

    [REQUIRED]

    Total amount of time for a deployment to last.

  • FinalBakeTimeInMinutes (integer) -- The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
  • GrowthFactor (float) --

    [REQUIRED]

    The percentage of targets to receive a deployed configuration during each interval.

  • GrowthType (string) -- The algorithm used to define how percentage grows over time.
  • ReplicateTo (string) --

    [REQUIRED]

    Save the deployment strategy to a Systems Manager (SSM) document.

  • Tags (dict) --

    Metadata to assign to the deployment strategy. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'ReplicateTo': 'NONE'|'SSM_DOCUMENT'
}

Response Structure

  • (dict) --

    • Id (string) --

      The deployment strategy ID.

    • Name (string) --

      The name of the deployment strategy.

    • Description (string) --

      The description of the deployment strategy.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets that received a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • ReplicateTo (string) --

      Save the deployment strategy to a Systems Manager (SSM) document.

create_environment(**kwargs)

For each application, you define one or more environments. An environment is a logical deployment group of AppConfig targets, such as applications in a Beta or Production environment. You can also define environments for application subcomponents such as the Web , Mobile and Back-end components for your application. You can configure Amazon CloudWatch alarms for each environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system rolls back the configuration.

See also: AWS API Documentation

Request Syntax

response = client.create_environment(
    ApplicationId='string',
    Name='string',
    Description='string',
    Monitors=[
        {
            'AlarmArn': 'string',
            'AlarmRoleArn': 'string'
        },
    ],
    Tags={
        'string': 'string'
    }
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • Name (string) --

    [REQUIRED]

    A name for the environment.

  • Description (string) -- A description of the environment.
  • Monitors (list) --

    Amazon CloudWatch alarms to monitor during the deployment process.

    • (dict) --

      Amazon CloudWatch alarms to monitor during the deployment process.

      • AlarmArn (string) --

        ARN of the Amazon CloudWatch alarm.

      • AlarmRoleArn (string) --

        ARN of an IAM role for AppConfig to monitor AlarmArn .

  • Tags (dict) --

    Metadata to assign to the environment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'State': 'READY_FOR_DEPLOYMENT'|'DEPLOYING'|'ROLLING_BACK'|'ROLLED_BACK',
    'Monitors': [
        {
            'AlarmArn': 'string',
            'AlarmRoleArn': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The environment ID.

    • Name (string) --

      The name of the environment.

    • Description (string) --

      The description of the environment.

    • State (string) --

      The state of the environment. An environment can be in one of the following states: READY_FOR_DEPLOYMENT , DEPLOYING , ROLLING_BACK , or ROLLED_BACK

    • Monitors (list) --

      Amazon CloudWatch alarms monitored during the deployment.

      • (dict) --

        Amazon CloudWatch alarms to monitor during the deployment process.

        • AlarmArn (string) --

          ARN of the Amazon CloudWatch alarm.

        • AlarmRoleArn (string) --

          ARN of an IAM role for AppConfig to monitor AlarmArn .

delete_application(**kwargs)

Delete an application. Deleting an application does not delete a configuration from a host.

See also: AWS API Documentation

Request Syntax

response = client.delete_application(
    ApplicationId='string'
)
Parameters
ApplicationId (string) --

[REQUIRED]

The ID of the application to delete.

Returns
None
delete_configuration_profile(**kwargs)

Delete a configuration profile. Deleting a configuration profile does not delete a configuration from a host.

See also: AWS API Documentation

Request Syntax

response = client.delete_configuration_profile(
    ApplicationId='string',
    ConfigurationProfileId='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID that includes the configuration profile you want to delete.

  • ConfigurationProfileId (string) --

    [REQUIRED]

    The ID of the configuration profile you want to delete.

Returns

None

delete_deployment_strategy(**kwargs)

Delete a deployment strategy. Deleting a deployment strategy does not delete a configuration from a host.

See also: AWS API Documentation

Request Syntax

response = client.delete_deployment_strategy(
    DeploymentStrategyId='string'
)
Parameters
DeploymentStrategyId (string) --

[REQUIRED]

The ID of the deployment strategy you want to delete.

Returns
None
delete_environment(**kwargs)

Delete an environment. Deleting an environment does not delete a configuration from a host.

See also: AWS API Documentation

Request Syntax

response = client.delete_environment(
    ApplicationId='string',
    EnvironmentId='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID that includes the environment you want to delete.

  • EnvironmentId (string) --

    [REQUIRED]

    The ID of the environment you want to delete.

Returns

None

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_application(**kwargs)

Retrieve information about an application.

See also: AWS API Documentation

Request Syntax

response = client.get_application(
    ApplicationId='string'
)
Parameters
ApplicationId (string) --

[REQUIRED]

The ID of the application you want to get.

Return type
dict
Returns
Response Syntax
{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string'
}

Response Structure

  • (dict) --
    • Id (string) --

      The application ID.

    • Name (string) --

      The application name.

    • Description (string) --

      The description of the application.

get_configuration(**kwargs)

Retrieve information about a configuration.

See also: AWS API Documentation

Request Syntax

response = client.get_configuration(
    Application='string',
    Environment='string',
    Configuration='string',
    ClientId='string',
    ClientConfigurationVersion='string'
)
Parameters
  • Application (string) --

    [REQUIRED]

    The application to get.

  • Environment (string) --

    [REQUIRED]

    The environment to get.

  • Configuration (string) --

    [REQUIRED]

    The configuration to get.

  • ClientId (string) --

    [REQUIRED]

    A unique ID to identify the client for the configuration. This ID enables AppConfig to deploy the configuration in intervals, as defined in the deployment strategy.

  • ClientConfigurationVersion (string) -- The configuration version returned in the most recent GetConfiguration response.
Return type

dict

Returns

Response Syntax

{
    'Content': StreamingBody(),
    'ConfigurationVersion': 'string',
    'ContentType': 'string'
}

Response Structure

  • (dict) --

    • Content (StreamingBody) --

      The content of the configuration or the configuration data.

    • ConfigurationVersion (string) --

      The configuration version.

    • ContentType (string) --

      A standard MIME type describing the format of the configuration content. For more information, see Content-Type .

get_configuration_profile(**kwargs)

Retrieve information about a configuration profile.

See also: AWS API Documentation

Request Syntax

response = client.get_configuration_profile(
    ApplicationId='string',
    ConfigurationProfileId='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The ID of the application that includes the configuration profile you want to get.

  • ConfigurationProfileId (string) --

    [REQUIRED]

    The ID of the configuration profile you want to get.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'LocationUri': 'string',
    'RetrievalRoleArn': 'string',
    'Validators': [
        {
            'Type': 'JSON_SCHEMA'|'LAMBDA',
            'Content': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The configuration profile ID.

    • Name (string) --

      The name of the configuration profile.

    • Description (string) --

      The configuration profile description.

    • LocationUri (string) --

      The URI location of the configuration.

    • RetrievalRoleArn (string) --

      The ARN of an IAM role with permission to access the configuration at the specified LocationUri.

    • Validators (list) --

      A list of methods for validating the configuration.

      • (dict) --

        A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.

        • Type (string) --

          AppConfig supports validators of type JSON_SCHEMA and LAMBDA

        • Content (string) --

          Either the JSON Schema content or an AWS Lambda function name.

get_deployment(**kwargs)

Retrieve information about a configuration deployment.

See also: AWS API Documentation

Request Syntax

response = client.get_deployment(
    ApplicationId='string',
    EnvironmentId='string',
    DeploymentNumber=123
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The ID of the application that includes the deployment you want to get.

  • EnvironmentId (string) --

    [REQUIRED]

    The ID of the environment that includes the deployment you want to get.

  • DeploymentNumber (integer) --

    [REQUIRED]

    The sequence number of the deployment.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'EnvironmentId': 'string',
    'DeploymentStrategyId': 'string',
    'ConfigurationProfileId': 'string',
    'DeploymentNumber': 123,
    'ConfigurationName': 'string',
    'ConfigurationLocationUri': 'string',
    'ConfigurationVersion': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'State': 'BAKING'|'VALIDATING'|'DEPLOYING'|'COMPLETE'|'ROLLING_BACK'|'ROLLED_BACK',
    'PercentageComplete': ...,
    'StartedAt': datetime(2015, 1, 1),
    'CompletedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The ID of the application that was deployed.

    • EnvironmentId (string) --

      The ID of the environment that was deployed.

    • DeploymentStrategyId (string) --

      The ID of the deployment strategy that was deployed.

    • ConfigurationProfileId (string) --

      The ID of the configuration profile that was deployed.

    • DeploymentNumber (integer) --

      The sequence number of the deployment.

    • ConfigurationName (string) --

      The name of the configuration.

    • ConfigurationLocationUri (string) --

      Information about the source location of the configuration.

    • ConfigurationVersion (string) --

      The configuration version that was deployed.

    • Description (string) --

      The description of the deployment.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets to receive a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • State (string) --

      The state of the deployment.

    • PercentageComplete (float) --

      The percentage of targets for which the deployment is available.

    • StartedAt (datetime) --

      The time the deployment started.

    • CompletedAt (datetime) --

      The time the deployment completed.

get_deployment_strategy(**kwargs)

Retrieve information about a deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.

See also: AWS API Documentation

Request Syntax

response = client.get_deployment_strategy(
    DeploymentStrategyId='string'
)
Parameters
DeploymentStrategyId (string) --

[REQUIRED]

The ID of the deployment strategy to get.

Return type
dict
Returns
Response Syntax
{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'ReplicateTo': 'NONE'|'SSM_DOCUMENT'
}

Response Structure

  • (dict) --
    • Id (string) --

      The deployment strategy ID.

    • Name (string) --

      The name of the deployment strategy.

    • Description (string) --

      The description of the deployment strategy.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets that received a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • ReplicateTo (string) --

      Save the deployment strategy to a Systems Manager (SSM) document.

get_environment(**kwargs)

Retrieve information about an environment. An environment is a logical deployment group of AppConfig applications, such as applications in a Production environment or in an EU_Region environment. Each configuration deployment targets an environment. You can enable one or more Amazon CloudWatch alarms for an environment. If an alarm is triggered during a deployment, AppConfig roles back the configuration.

See also: AWS API Documentation

Request Syntax

response = client.get_environment(
    ApplicationId='string',
    EnvironmentId='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The ID of the application that includes the environment you want to get.

  • EnvironmentId (string) --

    [REQUIRED]

    The ID of the environment you wnat to get.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'State': 'READY_FOR_DEPLOYMENT'|'DEPLOYING'|'ROLLING_BACK'|'ROLLED_BACK',
    'Monitors': [
        {
            'AlarmArn': 'string',
            'AlarmRoleArn': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The environment ID.

    • Name (string) --

      The name of the environment.

    • Description (string) --

      The description of the environment.

    • State (string) --

      The state of the environment. An environment can be in one of the following states: READY_FOR_DEPLOYMENT , DEPLOYING , ROLLING_BACK , or ROLLED_BACK

    • Monitors (list) --

      Amazon CloudWatch alarms monitored during the deployment.

      • (dict) --

        Amazon CloudWatch alarms to monitor during the deployment process.

        • AlarmArn (string) --

          ARN of the Amazon CloudWatch alarm.

        • AlarmRoleArn (string) --

          ARN of an IAM role for AppConfig to monitor AlarmArn .

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_applications(**kwargs)

List all applications in your AWS account.

See also: AWS API Documentation

Request Syntax

response = client.list_applications(
    MaxResults=123,
    NextToken='string'
)
Parameters
  • MaxResults (integer) -- The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
  • NextToken (string) -- A token to start the list. Use this token to get the next set of results.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'Id': 'string',
            'Name': 'string',
            'Description': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The elements from this collection.

      • (dict) --

        • Id (string) --

          The application ID.

        • Name (string) --

          The application name.

        • Description (string) --

          The description of the application.

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.

list_configuration_profiles(**kwargs)

Lists the configuration profiles for an application.

See also: AWS API Documentation

Request Syntax

response = client.list_configuration_profiles(
    ApplicationId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • MaxResults (integer) -- The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
  • NextToken (string) -- A token to start the list. Use this token to get the next set of results.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'ApplicationId': 'string',
            'Id': 'string',
            'Name': 'string',
            'LocationUri': 'string',
            'ValidatorTypes': [
                'JSON_SCHEMA'|'LAMBDA',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The elements from this collection.

      • (dict) --

        A summary of a configuration profile.

        • ApplicationId (string) --

          The application ID.

        • Id (string) --

          The ID of the configuration profile.

        • Name (string) --

          The name of the configuration profile.

        • LocationUri (string) --

          The URI location of the configuration.

        • ValidatorTypes (list) --

          The types of validators in the configuration profile.

          • (string) --
    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.

list_deployment_strategies(**kwargs)

List deployment strategies.

See also: AWS API Documentation

Request Syntax

response = client.list_deployment_strategies(
    MaxResults=123,
    NextToken='string'
)
Parameters
  • MaxResults (integer) -- The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
  • NextToken (string) -- A token to start the list. Use this token to get the next set of results.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'Id': 'string',
            'Name': 'string',
            'Description': 'string',
            'DeploymentDurationInMinutes': 123,
            'GrowthType': 'LINEAR',
            'GrowthFactor': ...,
            'FinalBakeTimeInMinutes': 123,
            'ReplicateTo': 'NONE'|'SSM_DOCUMENT'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The elements from this collection.

      • (dict) --

        • Id (string) --

          The deployment strategy ID.

        • Name (string) --

          The name of the deployment strategy.

        • Description (string) --

          The description of the deployment strategy.

        • DeploymentDurationInMinutes (integer) --

          Total amount of time the deployment lasted.

        • GrowthType (string) --

          The algorithm used to define how percentage grew over time.

        • GrowthFactor (float) --

          The percentage of targets that received a deployed configuration during each interval.

        • FinalBakeTimeInMinutes (integer) --

          The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

        • ReplicateTo (string) --

          Save the deployment strategy to a Systems Manager (SSM) document.

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.

list_deployments(**kwargs)

Lists the deployments for an environment.

See also: AWS API Documentation

Request Syntax

response = client.list_deployments(
    ApplicationId='string',
    EnvironmentId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • EnvironmentId (string) --

    [REQUIRED]

    The environment ID.

  • MaxResults (integer) -- The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
  • NextToken (string) -- A token to start the list. Use this token to get the next set of results.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'DeploymentNumber': 123,
            'ConfigurationName': 'string',
            'ConfigurationVersion': 'string',
            'DeploymentDurationInMinutes': 123,
            'GrowthType': 'LINEAR',
            'GrowthFactor': ...,
            'FinalBakeTimeInMinutes': 123,
            'State': 'BAKING'|'VALIDATING'|'DEPLOYING'|'COMPLETE'|'ROLLING_BACK'|'ROLLED_BACK',
            'PercentageComplete': ...,
            'StartedAt': datetime(2015, 1, 1),
            'CompletedAt': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The elements from this collection.

      • (dict) --

        Information about the deployment.

        • DeploymentNumber (integer) --

          The sequence number of the deployment.

        • ConfigurationName (string) --

          The name of the configuration.

        • ConfigurationVersion (string) --

          The version of the configuration.

        • DeploymentDurationInMinutes (integer) --

          Total amount of time the deployment lasted.

        • GrowthType (string) --

          The algorithm used to define how percentage grows over time.

        • GrowthFactor (float) --

          The percentage of targets to receive a deployed configuration during each interval.

        • FinalBakeTimeInMinutes (integer) --

          The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

        • State (string) --

          The state of the deployment.

        • PercentageComplete (float) --

          The percentage of targets for which the deployment is available.

        • StartedAt (datetime) --

          Time the deployment started.

        • CompletedAt (datetime) --

          Time the deployment completed.

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.

list_environments(**kwargs)

List the environments for an application.

See also: AWS API Documentation

Request Syntax

response = client.list_environments(
    ApplicationId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • MaxResults (integer) -- The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
  • NextToken (string) -- A token to start the list. Use this token to get the next set of results.
Return type

dict

Returns

Response Syntax

{
    'Items': [
        {
            'ApplicationId': 'string',
            'Id': 'string',
            'Name': 'string',
            'Description': 'string',
            'State': 'READY_FOR_DEPLOYMENT'|'DEPLOYING'|'ROLLING_BACK'|'ROLLED_BACK',
            'Monitors': [
                {
                    'AlarmArn': 'string',
                    'AlarmRoleArn': 'string'
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The elements from this collection.

      • (dict) --

        • ApplicationId (string) --

          The application ID.

        • Id (string) --

          The environment ID.

        • Name (string) --

          The name of the environment.

        • Description (string) --

          The description of the environment.

        • State (string) --

          The state of the environment. An environment can be in one of the following states: READY_FOR_DEPLOYMENT , DEPLOYING , ROLLING_BACK , or ROLLED_BACK

        • Monitors (list) --

          Amazon CloudWatch alarms monitored during the deployment.

          • (dict) --

            Amazon CloudWatch alarms to monitor during the deployment process.

            • AlarmArn (string) --

              ARN of the Amazon CloudWatch alarm.

            • AlarmRoleArn (string) --

              ARN of an IAM role for AppConfig to monitor AlarmArn .

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.

list_tags_for_resource(**kwargs)

Retrieves the list of key-value tags assigned to the resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    ResourceArn='string'
)
Parameters
ResourceArn (string) --

[REQUIRED]

The resource ARN.

Return type
dict
Returns
Response Syntax
{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --
    • Tags (dict) --

      Metadata to assign to AppConfig resources. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

      • (string) --
        • (string) --
start_deployment(**kwargs)

Starts a deployment.

See also: AWS API Documentation

Request Syntax

response = client.start_deployment(
    ApplicationId='string',
    EnvironmentId='string',
    DeploymentStrategyId='string',
    ConfigurationProfileId='string',
    ConfigurationVersion='string',
    Description='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • EnvironmentId (string) --

    [REQUIRED]

    The environment ID.

  • DeploymentStrategyId (string) --

    [REQUIRED]

    The deployment strategy ID.

  • ConfigurationProfileId (string) --

    [REQUIRED]

    The configuration profile ID.

  • ConfigurationVersion (string) --

    [REQUIRED]

    The configuration version to deploy.

  • Description (string) -- A description of the deployment.
  • Tags (dict) --

    Metadata to assign to the deployment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'EnvironmentId': 'string',
    'DeploymentStrategyId': 'string',
    'ConfigurationProfileId': 'string',
    'DeploymentNumber': 123,
    'ConfigurationName': 'string',
    'ConfigurationLocationUri': 'string',
    'ConfigurationVersion': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'State': 'BAKING'|'VALIDATING'|'DEPLOYING'|'COMPLETE'|'ROLLING_BACK'|'ROLLED_BACK',
    'PercentageComplete': ...,
    'StartedAt': datetime(2015, 1, 1),
    'CompletedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The ID of the application that was deployed.

    • EnvironmentId (string) --

      The ID of the environment that was deployed.

    • DeploymentStrategyId (string) --

      The ID of the deployment strategy that was deployed.

    • ConfigurationProfileId (string) --

      The ID of the configuration profile that was deployed.

    • DeploymentNumber (integer) --

      The sequence number of the deployment.

    • ConfigurationName (string) --

      The name of the configuration.

    • ConfigurationLocationUri (string) --

      Information about the source location of the configuration.

    • ConfigurationVersion (string) --

      The configuration version that was deployed.

    • Description (string) --

      The description of the deployment.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets to receive a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • State (string) --

      The state of the deployment.

    • PercentageComplete (float) --

      The percentage of targets for which the deployment is available.

    • StartedAt (datetime) --

      The time the deployment started.

    • CompletedAt (datetime) --

      The time the deployment completed.

stop_deployment(**kwargs)

Stops a deployment. This API action works only on deployments that have a status of DEPLOYING . This action moves the deployment to a status of ROLLED_BACK .

See also: AWS API Documentation

Request Syntax

response = client.stop_deployment(
    ApplicationId='string',
    EnvironmentId='string',
    DeploymentNumber=123
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • EnvironmentId (string) --

    [REQUIRED]

    The environment ID.

  • DeploymentNumber (integer) --

    [REQUIRED]

    The sequence number of the deployment.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'EnvironmentId': 'string',
    'DeploymentStrategyId': 'string',
    'ConfigurationProfileId': 'string',
    'DeploymentNumber': 123,
    'ConfigurationName': 'string',
    'ConfigurationLocationUri': 'string',
    'ConfigurationVersion': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'State': 'BAKING'|'VALIDATING'|'DEPLOYING'|'COMPLETE'|'ROLLING_BACK'|'ROLLED_BACK',
    'PercentageComplete': ...,
    'StartedAt': datetime(2015, 1, 1),
    'CompletedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The ID of the application that was deployed.

    • EnvironmentId (string) --

      The ID of the environment that was deployed.

    • DeploymentStrategyId (string) --

      The ID of the deployment strategy that was deployed.

    • ConfigurationProfileId (string) --

      The ID of the configuration profile that was deployed.

    • DeploymentNumber (integer) --

      The sequence number of the deployment.

    • ConfigurationName (string) --

      The name of the configuration.

    • ConfigurationLocationUri (string) --

      Information about the source location of the configuration.

    • ConfigurationVersion (string) --

      The configuration version that was deployed.

    • Description (string) --

      The description of the deployment.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets to receive a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • State (string) --

      The state of the deployment.

    • PercentageComplete (float) --

      The percentage of targets for which the deployment is available.

    • StartedAt (datetime) --

      The time the deployment started.

    • CompletedAt (datetime) --

      The time the deployment completed.

tag_resource(**kwargs)

Metadata to assign to an AppConfig resource. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    ResourceArn='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The ARN of the resource for which to retrieve tags.

  • Tags (dict) --

    [REQUIRED]

    The key-value string map. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start with aws: . The tag value can be up to 256 characters.

    • (string) --
      • (string) --
Returns

None

untag_resource(**kwargs)

Deletes a tag key and value from an AppConfig resource.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    ResourceArn='string',
    TagKeys=[
        'string',
    ]
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The ARN of the resource for which to remove tags.

  • TagKeys (list) --

    [REQUIRED]

    The tag keys to delete.

    • (string) --
Returns

None

update_application(**kwargs)

Updates an application.

See also: AWS API Documentation

Request Syntax

response = client.update_application(
    ApplicationId='string',
    Name='string',
    Description='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • Name (string) -- The name of the application.
  • Description (string) -- A description of the application.
Return type

dict

Returns

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string'
}

Response Structure

  • (dict) --

    • Id (string) --

      The application ID.

    • Name (string) --

      The application name.

    • Description (string) --

      The description of the application.

update_configuration_profile(**kwargs)

Updates a configuration profile.

See also: AWS API Documentation

Request Syntax

response = client.update_configuration_profile(
    ApplicationId='string',
    ConfigurationProfileId='string',
    Name='string',
    Description='string',
    RetrievalRoleArn='string',
    Validators=[
        {
            'Type': 'JSON_SCHEMA'|'LAMBDA',
            'Content': 'string'
        },
    ]
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • ConfigurationProfileId (string) --

    [REQUIRED]

    The ID of the configuration profile.

  • Name (string) -- The name of the configuration profile.
  • Description (string) -- A description of the configuration profile.
  • RetrievalRoleArn (string) -- The ARN of an IAM role with permission to access the configuration at the specified LocationUri.
  • Validators (list) --

    A list of methods for validating the configuration.

    • (dict) --

      A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.

      • Type (string) -- [REQUIRED]

        AppConfig supports validators of type JSON_SCHEMA and LAMBDA

      • Content (string) -- [REQUIRED]

        Either the JSON Schema content or an AWS Lambda function name.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'LocationUri': 'string',
    'RetrievalRoleArn': 'string',
    'Validators': [
        {
            'Type': 'JSON_SCHEMA'|'LAMBDA',
            'Content': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The configuration profile ID.

    • Name (string) --

      The name of the configuration profile.

    • Description (string) --

      The configuration profile description.

    • LocationUri (string) --

      The URI location of the configuration.

    • RetrievalRoleArn (string) --

      The ARN of an IAM role with permission to access the configuration at the specified LocationUri.

    • Validators (list) --

      A list of methods for validating the configuration.

      • (dict) --

        A validator provides a syntactic or semantic check to ensure the configuration you want to deploy functions as intended. To validate your application configuration data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or update can only proceed when the configuration data is valid.

        • Type (string) --

          AppConfig supports validators of type JSON_SCHEMA and LAMBDA

        • Content (string) --

          Either the JSON Schema content or an AWS Lambda function name.

update_deployment_strategy(**kwargs)

Updates a deployment strategy.

See also: AWS API Documentation

Request Syntax

response = client.update_deployment_strategy(
    DeploymentStrategyId='string',
    Description='string',
    DeploymentDurationInMinutes=123,
    FinalBakeTimeInMinutes=123,
    GrowthFactor=...,
    GrowthType='LINEAR'
)
Parameters
  • DeploymentStrategyId (string) --

    [REQUIRED]

    The deployment strategy ID.

  • Description (string) -- A description of the deployment strategy.
  • DeploymentDurationInMinutes (integer) -- Total amount of time for a deployment to last.
  • FinalBakeTimeInMinutes (integer) -- The amount of time AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
  • GrowthFactor (float) -- The percentage of targets to receive a deployed configuration during each interval.
  • GrowthType (string) -- The algorithm used to define how percentage grows over time.
Return type

dict

Returns

Response Syntax

{
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'DeploymentDurationInMinutes': 123,
    'GrowthType': 'LINEAR',
    'GrowthFactor': ...,
    'FinalBakeTimeInMinutes': 123,
    'ReplicateTo': 'NONE'|'SSM_DOCUMENT'
}

Response Structure

  • (dict) --

    • Id (string) --

      The deployment strategy ID.

    • Name (string) --

      The name of the deployment strategy.

    • Description (string) --

      The description of the deployment strategy.

    • DeploymentDurationInMinutes (integer) --

      Total amount of time the deployment lasted.

    • GrowthType (string) --

      The algorithm used to define how percentage grew over time.

    • GrowthFactor (float) --

      The percentage of targets that received a deployed configuration during each interval.

    • FinalBakeTimeInMinutes (integer) --

      The amount of time AppConfig monitored for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

    • ReplicateTo (string) --

      Save the deployment strategy to a Systems Manager (SSM) document.

update_environment(**kwargs)

Updates an environment.

See also: AWS API Documentation

Request Syntax

response = client.update_environment(
    ApplicationId='string',
    EnvironmentId='string',
    Name='string',
    Description='string',
    Monitors=[
        {
            'AlarmArn': 'string',
            'AlarmRoleArn': 'string'
        },
    ]
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • EnvironmentId (string) --

    [REQUIRED]

    The environment ID.

  • Name (string) -- The name of the environment.
  • Description (string) -- A description of the environment.
  • Monitors (list) --

    Amazon CloudWatch alarms to monitor during the deployment process.

    • (dict) --

      Amazon CloudWatch alarms to monitor during the deployment process.

      • AlarmArn (string) --

        ARN of the Amazon CloudWatch alarm.

      • AlarmRoleArn (string) --

        ARN of an IAM role for AppConfig to monitor AlarmArn .

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'State': 'READY_FOR_DEPLOYMENT'|'DEPLOYING'|'ROLLING_BACK'|'ROLLED_BACK',
    'Monitors': [
        {
            'AlarmArn': 'string',
            'AlarmRoleArn': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ApplicationId (string) --

      The application ID.

    • Id (string) --

      The environment ID.

    • Name (string) --

      The name of the environment.

    • Description (string) --

      The description of the environment.

    • State (string) --

      The state of the environment. An environment can be in one of the following states: READY_FOR_DEPLOYMENT , DEPLOYING , ROLLING_BACK , or ROLLED_BACK

    • Monitors (list) --

      Amazon CloudWatch alarms monitored during the deployment.

      • (dict) --

        Amazon CloudWatch alarms to monitor during the deployment process.

        • AlarmArn (string) --

          ARN of the Amazon CloudWatch alarm.

        • AlarmRoleArn (string) --

          ARN of an IAM role for AppConfig to monitor AlarmArn .

validate_configuration(**kwargs)

Uses the validators in a configuration profile to validate a configuration.

See also: AWS API Documentation

Request Syntax

response = client.validate_configuration(
    ApplicationId='string',
    ConfigurationProfileId='string',
    ConfigurationVersion='string'
)
Parameters
  • ApplicationId (string) --

    [REQUIRED]

    The application ID.

  • ConfigurationProfileId (string) --

    [REQUIRED]

    The configuration profile ID.

  • ConfigurationVersion (string) --

    [REQUIRED]

    The version of the configuration to validate.

Returns

None

Paginators

The available paginators are: