Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Specifying the action version to use

PDF
Focus mode
Specifying the action version to use - Amazon CodeCatalyst

By default, when you add an action to a workflow, Amazon CodeCatalyst adds the full version to the workflow definition file using the format:

vmajor.minor.patch

For example:

My-Build-Action:
  Identifier: aws/build@v1.0.0

You can shorten the full version in the Identifier property so that the workflow always uses the latest minor or patch version of the action.

For example, if you specify:

My-CloudFormation-Action:
  Identifier: aws/cfn-deploy@v1.0

...and the latest patch version is 1.0.4, then the action will use 1.0.4. If a later version is released, say 1.0.5, then the action will use 1.0.5. If a minor version is released, say 1.1.0, then the action will continue to use 1.0.5.

For detailed instructions on specifying versions, see one of the following topics.

Use the following instructions to indicate which version of an action you want your workflow to use. You can specify the latest major or minor version, or a specific patch version.

We recommend using the latest minor or patch version of an action.

Visual

Not available. Choose YAML to view the YAML instructions.

YAML
To configure a workflow to use the latest version of an action, or a specific patch version

  1. Open the CodeCatalyst console at https://codecatalyst.aws/.

  2. Choose your project.

  3. In the navigation pane, choose CI/CD, and then choose Workflows.

  4. Choose the name of your workflow. You can filter by the source repository or branch name where the workflow is defined, or filter by workflow name or status.

  5. Choose Edit.

  6. Choose YAML.

  7. Find the action whose version you want to edit.

  8. Find the action's Identifier property, and set the version to one of the following:

    • action-identifier@vmajor – Use this syntax to have the workflow use a specific major version, and allow the latest minor and patch versions to be chosen automatically.

    • action-identifier@vmajor.minor – Use this syntax to have the workflow use a specific minor version, and allow the latest patch version to be chosen automatically.

    • action-identifier@vmajor.minor.patch – Use this syntax to have the workflow use a specific patch version.

    Note

    If you're not sure which versions are available, see Listing the available action versions.

    Note

    You cannot omit the major version.

  9. (Optional) Choose Validate to validate the workflow's YAML code before committing.

  10. Choose Commit, enter a commit message, and choose Commit again.

anchoranchor

Not available. Choose YAML to view the YAML instructions.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.