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.

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.

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)

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.