create_recommendation_template

ResilienceHub.Client.create_recommendation_template(**kwargs)

Creates a new recommendation template for the AWS Resilience Hub application.

See also: AWS API Documentation

Request Syntax

response = client.create_recommendation_template(
    assessmentArn='string',
    bucketName='string',
    clientToken='string',
    format='CfnYaml'|'CfnJson',
    name='string',
    recommendationIds=[
        'string',
    ],
    recommendationTypes=[
        'Alarm'|'Sop'|'Test',
    ],
    tags={
        'string': 'string'
    }
)

Parameters

• assessmentArn (string) --

  [REQUIRED]

  The Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn: partition :resiliencehub: region : account :app-assessment/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.

• bucketName (string) -- The name of the Amazon S3 bucket that will contain the recommendation template.
• clientToken (string) --

  Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.

  This field is autopopulated if not provided.

• format (string) --

  The format for the recommendation template.

  CfnJson

  The template is CloudFormation JSON.

  CfnYaml

  The template is CloudFormation YAML.

• name (string) --

  [REQUIRED]

  The name for the recommendation template.

• recommendationIds (list) --

  Identifiers for the recommendations used to create a recommendation template.

  • (string) --
• recommendationTypes (list) --

  An array of strings that specify the recommendation template type or types.

  Alarm

  The template is an AlarmRecommendation template.

  Sop

  The template is a SopRecommendation template.

  Test

  The template is a TestRecommendation template.

  • (string) --
• tags (dict) --

  The tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key/value pair.

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

Return type

dict

Returns

Response Syntax

{
    'recommendationTemplate': {
        'appArn': 'string',
        'assessmentArn': 'string',
        'endTime': datetime(2015, 1, 1),
        'format': 'CfnYaml'|'CfnJson',
        'message': 'string',
        'name': 'string',
        'needsReplacements': True|False,
        'recommendationIds': [
            'string',
        ],
        'recommendationTemplateArn': 'string',
        'recommendationTypes': [
            'Alarm'|'Sop'|'Test',
        ],
        'startTime': datetime(2015, 1, 1),
        'status': 'Pending'|'InProgress'|'Failed'|'Success',
        'tags': {
            'string': 'string'
        },
        'templatesLocation': {
            'bucket': 'string',
            'prefix': 'string'
        }
    }
}

Response Structure

• (dict) --

  • recommendationTemplate (dict) --

    The newly created recommendation template, returned as an object. This object includes the template's name, format, status, tags, Amazon S3 bucket location, and more.

    • appArn (string) --

      The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn: partition :resiliencehub: region : account :app/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.

    • assessmentArn (string) --

      The Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn: partition :resiliencehub: region : account :app-assessment/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.

    • endTime (datetime) --

      The end time for the action.

    • format (string) --

      The format of the recommendation template.

      CfnJson

      The template is CloudFormation JSON.

      CfnYaml

      The template is CloudFormation YAML.

    • message (string) --

      The message for the recommendation template.

    • name (string) --

      The name for the recommendation template.

    • needsReplacements (boolean) --

      Indicates if replacements are needed.

    • recommendationIds (list) --

      Identifiers for the recommendations used in the recommendation template.

      • (string) --

    • recommendationTemplateArn (string) --

      The Amazon Resource Name (ARN) for the recommendation template.

    • recommendationTypes (list) --

      An array of strings that specify the recommendation template type or types.

      Alarm

      The template is an AlarmRecommendation template.

      Sop

      The template is a SopRecommendation template.

      Test

      The template is a TestRecommendation template.

      • (string) --

    • startTime (datetime) --

      The start time for the action.

    • status (string) --

      The status of the action.

    • tags (dict) --

      The tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key/value pair.

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

    • templatesLocation (dict) --

      The file location of the template.

      • bucket (string) --

        The name of the Amazon S3 bucket.

      • prefix (string) --

        The prefix for the Amazon S3 bucket.

Exceptions

• ResilienceHub.Client.exceptions.InternalServerException
• ResilienceHub.Client.exceptions.ResourceNotFoundException
• ResilienceHub.Client.exceptions.ConflictException
• ResilienceHub.Client.exceptions.ServiceQuotaExceededException
• ResilienceHub.Client.exceptions.ThrottlingException
• ResilienceHub.Client.exceptions.ValidationException
• ResilienceHub.Client.exceptions.AccessDeniedException