| aws-region | AWS Region, e.g. us-east-2 | yes | — |
| aws-profile | Name of the AWS profile to configure. When provided, credentials are written to ~/.aws/credentials and ~/.aws/config files instead of env variables (unless output-env-credentials is manually set to true). Name cannot contain whitespace, square brackets, or slashes. | no | — |
| overwrite-aws-profile | Overwrite the given AWS profile if it already exists. Requires aws-profile. When set to false or not set, an error will be thrown if the profile already exists. | no | — |
| role-to-assume | The Amazon Resource Name (ARN) of the role to assume. Use the provided credentials to assume an IAM role and configure the Actions environment with the assumed role credentials rather than with the provided credentials. | no | — |
| aws-access-key-id | AWS Access Key ID. Provide this key if you want to assume a role using access keys rather than a web identity token. | no | — |
| aws-secret-access-key | AWS Secret Access Key. Required if aws-access-key-id is provided. | no | — |
| aws-session-token | AWS Session Token. | no | — |
| web-identity-token-file | Use the web identity token file from the provided file system path in order to assume an IAM role using a web identity, e.g. from within an Amazon EKS worker node. | no | — |
| role-chaining | Use existing credentials from the environment to assume a new role, rather than providing credentials as input. | no | — |
| audience | The audience to use for the OIDC provider | no | sts.amazonaws.com |
| http-proxy | Proxy to use for the AWS SDK agent | no | — |
| no-proxy | Hosts to skip for the proxy configuration | no | — |
| mask-aws-account-id | Whether to mask the AWS account ID for these credentials as a secret value. By default the account ID will not be masked | no | — |
| role-duration-seconds | Role duration in seconds. Default is one hour. | no | — |
| role-external-id | The external ID of the role to assume. | no | — |
| role-session-name | Role session name (default: GitHubActions) | no | — |
| role-skip-session-tagging | Skip session tagging during role assumption | no | — |
| transitive-tag-keys | Define a list of transitive tag keys to pass when assuming a role | no | — |
| inline-session-policy | Define an inline session policy to use when assuming a role | no | — |
| managed-session-policies | Define a list of managed session policies to use when assuming a role | no | — |
| output-credentials | Whether to set credentials as step output | no | — |
| output-env-credentials | Whether to export credentials as environment variables. If you set this to false, you probably want to use output-credentials. | no | — |
| unset-current-credentials | Whether to unset the existing credentials in your runner. May be useful if you run this action multiple times in the same job | no | — |
| disable-retry | Whether to disable the retry and backoff mechanism when the assume role call fails. By default the retry mechanism is enabled | no | — |
| retry-max-attempts | The maximum number of attempts it will attempt to retry the assume role call. By default it will retry 12 times | no | — |
| special-characters-workaround | Some environments do not support special characters in AWS_SECRET_ACCESS_KEY. This option will retry fetching credentials until the secret access key does not contain special characters. This option overrides disable-retry and retry-max-attempts. This option is disabled by default | no | — |
| use-existing-credentials | When enabled, this option will check if there are already valid credentials in the environment. If there are, new credentials will not be fetched. If there are not, the action will run as normal. | no | — |
| allowed-account-ids | An option comma-delimited list of expected AWS account IDs. The action will fail if we receive credentials for the wrong account. | no | — |
| force-skip-oidc | When enabled, this option will skip using GitHub OIDC provider even if the id-token permission is set. This is sometimes useful when using IAM instance credentials. | no | — |
| action-timeout-s | A global timeout in seconds for the action. When the timeout is reached, the action immediately exits. The default is to run without a timeout. | no | — |
| custom-tags | Additional tags to apply to the assumed role session. Must be a JSON object provided as a string. | no | — |
| sts-endpoint | Custom STS endpoint URL. Use this to point to an STS-compatible API (e.g. MinIO, LocalStack) instead of the default AWS STS endpoint for the region. | no | — |