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