Saving a milestone

Overview

A milestone records the state of a workload at a particular point in time.

Save a milestone after you initially complete all the questions associated with a workload. As you change your workload based on items in your improvement plan, you can save additional milestones to measure progress.

A best practice is to save a milestone when you first do a new W-A review, or every time you make improvements to a workload.

1. Create a Milestone

  1. Using the create-milestone API we will save our current progress as our first milestone
    aws wellarchitected create-milestone --workload-id "<WorkloadId>" --milestone-name Rev1
    
  2. The return value will be the WorkloadId and the Milestone number assigned. Milestone1

2. List all milestones

  1. If we want to see all milestones associated with a workload
  2. Using the list-milestones API you can see all milestones associated with a workload
    aws wellarchitected list-milestones --workload-id "<WorkloadId>" --max-results 50
    
  3. This will return a summary of the milestones you have created for the workload. Milestone2

3. Retrieve the results from a milestone

  1. Using the get-milestone API, you can see all of the metadata for a specific milestone:
    aws wellarchitected get-milestone --workload-id "<WorkloadId>" --milestone-number 1
    
  2. This will return the complete workload information for the workload milestone (such as when it was created and what lenses were included) Milestone3

4. List all question answers based from a milestone

  1. If you want to see all of the best practices for when the milestone was created, you can use
  2. Using the list-answers API, you can see all of the best practices for when the milestone was created:
    aws wellarchitected list-answers --workload-id "<WorkloadId>" --lens-alias "wellarchitected" --milestone-number 1
    
  3. This will return a large json structure with all of the questions and best practices for each pillar. Milestone4