mgn / Client / describe_launch_configuration_templates

describe_launch_configuration_templates

mgn.Client.describe_launch_configuration_templates(**kwargs)

Lists all Launch Configuration Templates, filtered by Launch Configuration Template IDs

See also: AWS API Documentation

Request Syntax

response = client.describe_launch_configuration_templates(
    launchConfigurationTemplateIDs=[
        'string',
    ],
    maxResults=123,
    nextToken='string'
)

Parameters:

• launchConfigurationTemplateIDs (list) –

  Request to filter Launch Configuration Templates list by Launch Configuration Template ID.

  • (string) –

• maxResults (integer) – Maximum results to be returned in DescribeLaunchConfigurationTemplates.

• nextToken (string) – Next pagination token returned from DescribeLaunchConfigurationTemplates.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'arn': 'string',
            'associatePublicIpAddress': True|False,
            'bootMode': 'LEGACY_BIOS'|'UEFI'|'USE_SOURCE',
            'copyPrivateIp': True|False,
            'copyTags': True|False,
            'ec2LaunchTemplateID': 'string',
            'enableMapAutoTagging': True|False,
            'largeVolumeConf': {
                'iops': 123,
                'throughput': 123,
                'volumeType': 'io1'|'io2'|'gp3'|'gp2'|'st1'|'sc1'|'standard'
            },
            'launchConfigurationTemplateID': 'string',
            'launchDisposition': 'STOPPED'|'STARTED',
            'licensing': {
                'osByol': True|False
            },
            'mapAutoTaggingMpeID': 'string',
            'postLaunchActions': {
                'cloudWatchLogGroupName': 'string',
                'deployment': 'TEST_AND_CUTOVER'|'CUTOVER_ONLY'|'TEST_ONLY',
                's3LogBucket': 'string',
                's3OutputKeyPrefix': 'string',
                'ssmDocuments': [
                    {
                        'actionName': 'string',
                        'externalParameters': {
                            'string': {
                                'dynamicPath': 'string'
                            }
                        },
                        'mustSucceedForCutover': True|False,
                        'parameters': {
                            'string': [
                                {
                                    'parameterName': 'string',
                                    'parameterType': 'STRING'
                                },
                            ]
                        },
                        'ssmDocumentName': 'string',
                        'timeoutSeconds': 123
                    },
                ]
            },
            'smallVolumeConf': {
                'iops': 123,
                'throughput': 123,
                'volumeType': 'io1'|'io2'|'gp3'|'gp2'|'st1'|'sc1'|'standard'
            },
            'smallVolumeMaxSize': 123,
            'tags': {
                'string': 'string'
            },
            'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • items (list) –

    List of items returned by DescribeLaunchConfigurationTemplates.

    • (dict) –

      • arn (string) –

        ARN of the Launch Configuration Template.

      • associatePublicIpAddress (boolean) –

        Associate public Ip address.

      • bootMode (string) –

        Launch configuration template boot mode.

      • copyPrivateIp (boolean) –

        Copy private Ip.

      • copyTags (boolean) –

        Copy tags.

      • ec2LaunchTemplateID (string) –

        EC2 launch template ID.

      • enableMapAutoTagging (boolean) –

        Enable map auto tagging.

      • largeVolumeConf (dict) –

        Large volume config.

        • iops (integer) –

          Launch template disk iops configuration.

        • throughput (integer) –

          Launch template disk throughput configuration.

        • volumeType (string) –

          Launch template disk volume type configuration.

      • launchConfigurationTemplateID (string) –

        ID of the Launch Configuration Template.

      • launchDisposition (string) –

        Launch disposition.

      • licensing (dict) –

        Configure Licensing.

        • osByol (boolean) –

          Configure BYOL OS licensing.

      • mapAutoTaggingMpeID (string) –

        Launch configuration template map auto tagging MPE ID.

      • postLaunchActions (dict) –

        Post Launch Actions of the Launch Configuration Template.

        • cloudWatchLogGroupName (string) –

          AWS Systems Manager Command’s CloudWatch log group name.

        • deployment (string) –

          Deployment type in which AWS Systems Manager Documents will be executed.

        • s3LogBucket (string) –

          AWS Systems Manager Command’s logs S3 log bucket.

        • s3OutputKeyPrefix (string) –

          AWS Systems Manager Command’s logs S3 output key prefix.

        • ssmDocuments (list) –

          AWS Systems Manager Documents.

          • (dict) –

            AWS Systems Manager Document.

            • actionName (string) –

              User-friendly name for the AWS Systems Manager Document.

            • externalParameters (dict) –

              AWS Systems Manager Document external parameters.

              • (string) –

                • (dict) –

                  AWS Systems Manager Document external parameter.

                  Note

                  This is a Tagged Union structure. Only one of the following top level keys will be set: dynamicPath. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

                  'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
                  

                  • dynamicPath (string) –

                    AWS Systems Manager Document external parameters dynamic path.

            • mustSucceedForCutover (boolean) –

              If true, Cutover will not be enabled if the document has failed.

            • parameters (dict) –

              AWS Systems Manager Document parameters.

              • (string) –

                • (list) –

                  • (dict) –

                    AWS Systems Manager Parameter Store parameter.

                    • parameterName (string) –

                      AWS Systems Manager Parameter Store parameter name.

                    • parameterType (string) –

                      AWS Systems Manager Parameter Store parameter type.

            • ssmDocumentName (string) –

              AWS Systems Manager Document name or full ARN.

            • timeoutSeconds (integer) –

              AWS Systems Manager Document timeout seconds.

      • smallVolumeConf (dict) –

        Small volume config.

        • iops (integer) –

          Launch template disk iops configuration.

        • throughput (integer) –

          Launch template disk throughput configuration.

        • volumeType (string) –

          Launch template disk volume type configuration.

      • smallVolumeMaxSize (integer) –

        Small volume maximum size.

      • tags (dict) –

        Tags of the Launch Configuration Template.

        • (string) –

          • (string) –

      • targetInstanceTypeRightSizingMethod (string) –

        Target instance type right-sizing method.

  • nextToken (string) –

    Next pagination token returned from DescribeLaunchConfigurationTemplates.

Exceptions

• mgn.Client.exceptions.UninitializedAccountException

• mgn.Client.exceptions.ResourceNotFoundException

• mgn.Client.exceptions.ValidationException