AWS serverless-application-model documentation change
Summary
Updated terminology: replaced 'AWS CloudFormation' with 'CloudFormation' throughout the document for consistency
Security assessment
Changes are purely terminological updates without modifying security implications. No vulnerabilities, security features, or incident responses are referenced. The core functionality around IAM capabilities, rollback behavior, and resource management remains unchanged.
Diff
diff --git a/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-deploy.md b/serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-deploy.md index e0877247b..2cf57e167 100644 --- a//serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-deploy.md +++ b//serverless-application-model/latest/developerguide/sam-cli-command-reference-sam-deploy.md @@ -30 +30 @@ The `sam deploy` command deploys an application to the AWS Cloud using AWS Cloud -Set the `SAM_CLI_POLL_DELAY` environment variable with a value of seconds in your shell to configure how often the AWS SAM CLI checks the AWS CloudFormation stack state, which is useful when seeing throttling from AWS CloudFormation. This env variable is used for polling `describe_stack` API calls, which are made while running `sam deploy`. +Set the `SAM_CLI_POLL_DELAY` environment variable with a value of seconds in your shell to configure how often the AWS SAM CLI checks the CloudFormation stack state, which is useful when seeing throttling from CloudFormation. This env variable is used for polling `describe_stack` API calls, which are made while running `sam deploy`. @@ -42 +42 @@ The following is an example of this variable: -A list of capabilities that you must specify to allow AWS CloudFormation to create certain stacks. Some stack templates might include resources that affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this option. The only valid values are `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`. If you have IAM resources, then you can specify either capability. If you have IAM resources with custom names, then you must specify `CAPABILITY_NAMED_IAM`. If you don't specify this option, then the operation returns an `InsufficientCapabilities` error. +A list of capabilities that you must specify to allow CloudFormation to create certain stacks. Some stack templates might include resources that affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this option. The only valid values are `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`. If you have IAM resources, then you can specify either capability. If you have IAM resources with custom names, then you must specify `CAPABILITY_NAMED_IAM`. If you don't specify this option, then the operation returns an `InsufficientCapabilities` error. @@ -69 +69 @@ Turn on debug logging to print the debug message that the AWS SAM CLI generates -Specify whether to roll back your AWS CloudFormation stack if an error occurs during a deployment. By default, if there's an error during a deployment, your AWS CloudFormation stack rolls back to the last stable state. If you specify `--disable-rollback` and an error occurs during a deployment, then resources that were created or updated before the error occurred aren't rolled back. +Specify whether to roll back your CloudFormation stack if an error occurs during a deployment. By default, if there's an error during a deployment, your CloudFormation stack rolls back to the last stable state. If you specify `--disable-rollback` and an error occurs during a deployment, then resources that were created or updated before the error occurred aren't rolled back. @@ -119 +119 @@ A map of metadata to attach to all artifacts that are referenced in your templat -Indicates whether to apply the changeset. Specify this option if you want to view your stack changes before applying the changeset. This command creates an AWS CloudFormation changeset and then exits without applying the changeset. To apply the changeset, run the same command without this option. +Indicates whether to apply the changeset. Specify this option if you want to view your stack changes before applying the changeset. This command creates an CloudFormation changeset and then exits without applying the changeset. To apply the changeset, run the same command without this option. @@ -129 +129 @@ Do not display a progress bar when uploading artifacts to Amazon S3. -A list of Amazon Simple Notification Service (Amazon SNS) topic ARNs that AWS CloudFormation associates with the stack. +A list of Amazon Simple Notification Service (Amazon SNS) topic ARNs that CloudFormation associates with the stack. @@ -156 +156 @@ You can specify either the `--disable-rollback` option or the `--on-failure` opt -A string that contains AWS CloudFormation parameter overrides encoded as key-value pairs. Each override uses the format `ParameterKey=name,ParameterValue=value`. Multiple overrides are separated by spaces. Here are two examples: +A string that contains CloudFormation parameter overrides encoded as key-value pairs. Each override uses the format `ParameterKey=name,ParameterValue=value`. Multiple overrides are separated by spaces. Here are two examples: @@ -191 +191 @@ Automatically create an Amazon S3 bucket to use for packaging and deploying for -The Amazon Resource Name (ARN) of an IAM role that AWS CloudFormation assumes when applying the changeset. +The Amazon Resource Name (ARN) of an IAM role that CloudFormation assumes when applying the changeset. @@ -196 +196 @@ The Amazon Resource Name (ARN) of an IAM role that AWS CloudFormation assumes wh -The name of the Amazon S3 bucket where this command uploads your AWS CloudFormation template. If your template is larger than 51,200 bytes, then either the `--s3-bucket` option or the `--resolve-s3` option is required. If you specify both the `--s3-bucket` and `--resolve-s3` options, then an error occurs. +The name of the Amazon S3 bucket where this command uploads your CloudFormation template. If your template is larger than 51,200 bytes, then either the `--s3-bucket` option or the `--resolve-s3` option is required. If you specify both the `--s3-bucket` and `--resolve-s3` options, then an error occurs. @@ -216 +216 @@ The list of signing profiles to sign your deployment packages with. This option -(Required) The name of the AWS CloudFormation stack that you're deploying to. If you specify an existing stack, then the command updates the stack. If you specify a new stack, then the command creates it. +(Required) The name of the CloudFormation stack that you're deploying to. If you specify an existing stack, then the command updates the stack. If you specify a new stack, then the command creates it. @@ -221 +221 @@ The list of signing profiles to sign your deployment packages with. This option -A list of tags to associate with the stack that is created or updated. AWS CloudFormation also propagates these tags to resources in the stack that support it. +A list of tags to associate with the stack that is created or updated. CloudFormation also propagates these tags to resources in the stack that support it. @@ -235 +235 @@ If you specify this option, then AWS SAM deploys only the template and the local -Output JSON for the AWS CloudFormation template. The default output is YAML. +Output JSON for the CloudFormation template. The default output is YAML.