Skip to content
This repository was archived by the owner on Dec 7, 2023. It is now read-only.

Commit bb9994a

Browse files
committed
periodic update 12 mar 2020
1 parent bdfd4bc commit bb9994a

File tree

315 files changed

+2219
-2434
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

315 files changed

+2219
-2434
lines changed

doc_source/AWS_CloudWatch.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,6 @@
33
**Resource Types**
44
+ [AWS::CloudWatch::Alarm](aws-properties-cw-alarm.md)
55
+ [AWS::CloudWatch::AnomalyDetector](aws-resource-cloudwatch-anomalydetector.md)
6+
+ [AWS::CloudWatch::CompositeAlarm](aws-resource-cloudwatch-compositealarm.md)
67
+ [AWS::CloudWatch::Dashboard](aws-resource-cloudwatch-dashboard.md)
78
+ [AWS::CloudWatch::InsightRule](aws-resource-cloudwatch-insightrule.md)

doc_source/ReleaseHistory.md

Lines changed: 93 additions & 19 deletions
Large diffs are not rendered by default.

doc_source/Welcome.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22

33
AWS CloudFormation is a service that helps you model and set up your Amazon Web Services resources so that you can spend less time managing those resources and more time focusing on your applications that run in AWS\. You create a template that describes all the AWS resources that you want \(like Amazon EC2 instances or Amazon RDS DB instances\), and AWS CloudFormation takes care of provisioning and configuring those resources for you\. You don't need to individually create and configure AWS resources and figure out what's dependent on what; AWS CloudFormation handles all of that\. The following scenarios demonstrate how AWS CloudFormation can help\.
44

5-
## Simplify Infrastructure Management<a name="w5653ab1b5b5"></a>
5+
## Simplify Infrastructure Management<a name="w5792ab1b5b5"></a>
66

77
For a scalable web application that also includes a back\-end database, you might use an Auto Scaling group, an Elastic Load Balancing load balancer, and an Amazon Relational Database Service database instance\. Normally, you might use each individual service to provision these resources\. And after you create the resources, you would have to configure them to work together\. All these tasks can add complexity and time before you even get your application up and running\.
88

99
Instead, you can create or modify an existing AWS CloudFormation template\. A template describes all of your resources and their properties\. When you use that template to create an AWS CloudFormation stack, AWS CloudFormation provisions the Auto Scaling group, load balancer, and database for you\. After the stack has been successfully created, your AWS resources are up and running\. You can delete the stack just as easily, which deletes all the resources in the stack\. By using AWS CloudFormation, you easily manage a collection of resources as a single unit\.
1010

11-
## Quickly Replicate Your Infrastructure<a name="w5653ab1b5b7"></a>
11+
## Quickly Replicate Your Infrastructure<a name="w5792ab1b5b7"></a>
1212

1313
If your application requires additional availability, you might replicate it in multiple regions so that if one region becomes unavailable, your users can still use your application in other regions\. The challenge in replicating your application is that it also requires you to replicate your resources\. Not only do you need to record all the resources that your application requires, but you must also provision and configure those resources in each region\.
1414

1515
When you use AWS CloudFormation, you can reuse your template to set up your resources consistently and repeatedly\. Just describe your resources once and then provision the same resources over and over in multiple regions\.
1616

17-
## Easily Control and Track Changes to Your Infrastructure<a name="w5653ab1b5b9"></a>
17+
## Easily Control and Track Changes to Your Infrastructure<a name="w5792ab1b5b9"></a>
1818

1919
In some cases, you might have underlying resources that you want to upgrade incrementally\. For example, you might change to a higher performing instance type in your Auto Scaling launch configuration so that you can reduce the maximum number of instances in your Auto Scaling group\. If problems occur after you complete the update, you might need to roll back your infrastructure to the original settings\. To do this manually, you not only have to remember which resources were changed, you also have to know what the original settings were\.
2020

2121
When you provision your infrastructure with AWS CloudFormation, the AWS CloudFormation template describes exactly what resources are provisioned and their settings\. Because these templates are text files, you simply track differences in your templates to track changes to your infrastructure, similar to the way developers control revisions to source code\. For example, you can use a version control system with your templates so that you know exactly what changes were made, who made them, and when\. If at any point you need to reverse changes to your infrastructure, you can use a previous version of your template\.
2222

23-
## Related Information<a name="w5653ab1b5c13"></a>
23+
## Related Information<a name="w5792ab1b5c13"></a>
2424
+ For more information about AWS CloudFormation stacks and templates, see [AWS CloudFormation Concepts](cfn-whatis-concepts.md)\.
2525
+ For an overview about how to use AWS CloudFormation, see [How Does AWS CloudFormation Work?](cfn-whatis-howdoesitwork.md)\.
2626
+ For pricing information, see [AWS CloudFormation Pricing](http://aws.amazon.com/cloudformation/pricing/)\.

doc_source/aws-attribute-creationpolicy.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ The creation policy is invoked only when AWS CloudFormation creates the associat
66

77
Use the `CreationPolicy` attribute when you want to wait on resource configuration actions before stack creation proceeds\. For example, if you install and configure software applications on an EC2 instance, you might want those applications to be running before proceeding\. In such cases, you can add a `CreationPolicy` attribute to the instance, and then send a success signal to the instance after the applications are installed and configured\. For a detailed example, see [Deploying Applications on Amazon EC2 with AWS CloudFormation](deploying.applications.md)\.
88

9-
## Syntax<a name="w5653ab1c26c19b7b9"></a>
9+
## Syntax<a name="w5792ab1c25c19b7b9"></a>
1010

1111
### JSON<a name="aws-attribute-creationpolicy-syntax.json"></a>
1212

@@ -57,9 +57,9 @@ The value must be in [ISO8601 duration format](http://en.wikipedia.org/wiki/ISO_
5757
*Type*: String
5858
*Required*: No
5959

60-
## Examples<a name="w5653ab1c26c19b7c13"></a>
60+
## Examples<a name="w5792ab1c25c19b7c13"></a>
6161

62-
### Auto Scaling Group<a name="w5653ab1c26c19b7c13b2"></a>
62+
### Auto Scaling Group<a name="w5792ab1c25c19b7c13b2"></a>
6363

6464
The following example shows how to add a creation policy to an Auto Scaling group\. The creation policy requires three success signals and times out after 15 minutes\.
6565

@@ -153,7 +153,7 @@ LaunchConfig:
153153
/opt/aws/bin/cfn-signal -e $? --stack ${AWS::StackName} --resource AutoScalingGroup --region ${AWS::Region}
154154
```
155155

156-
### WaitCondition<a name="w5653ab1c26c19b7c13b4"></a>
156+
### WaitCondition<a name="w5792ab1c25c19b7c13b4"></a>
157157

158158
The following example shows how to add a creation policy to a wait condition\.
159159

doc_source/aws-attribute-dependson.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ You can use the `DependsOn` attribute with any resource\. Here are some typical
1515
**Note**
1616
During a stack update, resources that depend on updated resources are updated automatically\. AWS CloudFormation makes no changes to the automatically\-updated resources, but, if a stack policy is associated with these resources, your account must have the permissions to update them\.
1717

18-
## Syntax<a name="w5653ab1c26c19c15c13"></a>
18+
## Syntax<a name="w5792ab1c25c19c15c13"></a>
1919

2020
The `DependsOn` attribute can take a single string or list of strings\.
2121

2222
```
2323
"DependsOn" : [ String, ... ]
2424
```
2525

26-
## Example<a name="w5653ab1c26c19c15c15"></a>
26+
## Example<a name="w5792ab1c25c19c15c15"></a>
2727

2828
The following template contains an [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource with a `DependsOn` attribute that specifies myDB, an [AWS::RDS::DBInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html)\. When AWS CloudFormation creates this stack, it first creates myDB, then creates Ec2Instance\.
2929

@@ -234,7 +234,7 @@ EC2Host:
234234
Ref: PublicSubnet
235235
```
236236

237-
### Amazon ECS Service and Auto Scaling Group<a name="w5653ab1c26c19c15c17c18"></a>
237+
### Amazon ECS Service and Auto Scaling Group<a name="w5792ab1c25c19c15c17c18"></a>
238238

239239
When you use Auto Scaling or Amazon Elastic Compute Cloud \(Amazon EC2\) to create container instances for an Amazon ECS cluster, the Amazon ECS service resource must have a dependency on the Auto Scaling group or Amazon EC2 instances, as shown in the following snippet\. That way the container instances are available and associated with the Amazon ECS cluster before AWS CloudFormation creates the Amazon ECS service\.
240240

@@ -292,7 +292,7 @@ service:
292292
Ref: taskdefinition
293293
```
294294

295-
### IAM Role Policy<a name="w5653ab1c26c19c15c17c20"></a>
295+
### IAM Role Policy<a name="w5792ab1c25c19c15c17c20"></a>
296296

297297
Resources that make additional calls to AWS require a service role, which permits a service to make calls to AWS on your behalf\. For example, the `AWS::CodeDeploy::DeploymentGroup` resource requires a service role so that CodeDeploy has permissions to deploy applications to your instances\. When you have a single template that defines a service role, the role's policy \(by using the `AWS::IAM::Policy` or `AWS::IAM::ManagedPolicy` resource\), and a resource that uses the role, add a dependency so that the resource depends on the role's policy\. This dependency ensures that the policy is available throughout the resource's lifecycle\.
298298

doc_source/aws-attribute-metadata.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ AWS CloudFormation does not validate the syntax within the Metadata attribute\.
77

88
You can retrieve this data using the AWS command [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-resource.html) or the [DescribeStackResource action](http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackResource.html)\.
99

10-
## Example<a name="w5653ab1c26c19c19b9"></a>
10+
## Example<a name="w5792ab1c25c19c19b9"></a>
1111

1212
The following template contains an Amazon S3 bucket resource with a Metadata attribute\.
1313

doc_source/aws-attribute-updatepolicy.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,7 @@ For an example that specifies the `UpdatePolicy` attribute for an `AWS::Lambda::
301301

302302
The following examples show how to add an update policy to an Auto Scaling group and how to maintain availability when updating metadata\.
303303

304-
### Add an UpdatePolicy to an Auto Scaling Group<a name="w5653ab1c26c19c23c19b4"></a>
304+
### Add an UpdatePolicy to an Auto Scaling Group<a name="w5792ab1c25c19c23c19b4"></a>
305305

306306
The following example shows how to add an update policy\. During an update, the Auto Scaling group updates instances in batches of two and keeps a minimum of one instance in service\. Because the `WaitOnResourceSignals` flag is set, the Auto Scaling group waits for new instances that are added to the group\. The new instances must signal the Auto Scaling group before it updates the next batch of instances\.
307307

@@ -377,7 +377,7 @@ ScheduledAction:
377377
StartTime: '2017-06-02T20 : 00 : 00Z'
378378
```
379379

380-
### AutoScalingReplacingUpdate Policy<a name="w5653ab1c26c19c23c19b6"></a>
380+
### AutoScalingReplacingUpdate Policy<a name="w5792ab1c25c19c23c19b6"></a>
381381

382382
The following example declares a policy that forces an associated Auto Scaling group to be replaced during an update\. For the update to succeed, a percentage of instances \(specified by the `MinSuccessfulPercentParameter` parameter\) must signal success within the `Timeout` period\.
383383

@@ -414,7 +414,7 @@ CreationPolicy:
414414
MinSuccessfulInstancesPercent: !Ref 'MinSuccessfulPercentParameter'
415415
```
416416

417-
### Maintain Availability When Updating the Metadata for the cfn\-init Helper Script<a name="w5653ab1c26c19c23c19b8"></a>
417+
### Maintain Availability When Updating the Metadata for the cfn\-init Helper Script<a name="w5792ab1c25c19c23c19b8"></a>
418418

419419
When you install software applications on your instances, you might use the [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html) metadata key and the [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-init.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-init.html) helper script to bootstrap the instances in your Auto Scaling group\. AWS CloudFormation installs the packages, runs the commands, and performs other bootstrapping actions described in the metadata\.
420420

@@ -425,7 +425,7 @@ Forcing a rolling update requires AWS CloudFormation to create a new instance an
425425

426426
To force a rolling update, change the logical ID of the launch configuration resource, and then update the stack and any references pointing to the original logic ID \(such as the associated Auto Scaling group\)\. AWS CloudFormation triggers a rolling update on the Auto Scaling group, replacing all instances\.
427427

428-
### Original Template<a name="w5653ab1c26c19c23c19c10"></a>
428+
### Original Template<a name="w5792ab1c25c19c23c19c10"></a>
429429

430430
```
431431
"LaunchConfig": {
@@ -439,7 +439,7 @@ To force a rolling update, change the logical ID of the launch configuration res
439439
}
440440
```
441441

442-
### Updated Logical ID<a name="w5653ab1c26c19c23c19c12"></a>
442+
### Updated Logical ID<a name="w5792ab1c25c19c23c19c12"></a>
443443

444444
```
445445
"LaunchConfigUpdateRubygemsPkg": {

doc_source/aws-properties-apitgateway-method-integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,4 +151,4 @@ If you specified `HTTP` or `AWS` for the `Type` property, you must specify this
151151
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
152152

153153
## See Also<a name="aws-properties-apitgateway-method-integration--seealso"></a>
154-
+ [Method](https://docs.aws.amazon.com/apigateway/api-reference/resource/method/) in the *Amazon API Gateway REST API Reference*
154+
+ [Method](https://docs.aws.amazon.com/apigateway/api-reference/resource/method/) in the *Amazon API Gateway REST API Reference*

doc_source/aws-properties-applicationautoscaling-scalabletarget-scheduledaction.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ To declare this entity in your AWS CloudFormation template, use the following sy
3434
## Properties<a name="aws-properties-applicationautoscaling-scalabletarget-scheduledaction-properties"></a>
3535

3636
`EndTime` <a name="cfn-applicationautoscaling-scalabletarget-scheduledaction-endtime"></a>
37-
The date and time that the action is scheduled to end\.
37+
The date and time for the recurring schedule to end\.
3838
*Required*: No
3939
*Type*: Timestamp
4040
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
@@ -61,7 +61,7 @@ For more information about cron expressions, see [Cron Expressions](https://docs
6161
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
6262

6363
`ScheduledActionName` <a name="cfn-applicationautoscaling-scalabletarget-scheduledaction-scheduledactionname"></a>
64-
The name of the scheduled action\.
64+
The name of the scheduled action\. This name must be unique among all other scheduled actions on the specified scalable target\.
6565
*Required*: Yes
6666
*Type*: String
6767
*Minimum*: `1`
@@ -70,7 +70,7 @@ The name of the scheduled action\.
7070
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
7171

7272
`StartTime` <a name="cfn-applicationautoscaling-scalabletarget-scheduledaction-starttime"></a>
73-
The date and time that the action is scheduled to begin\.
73+
The date and time that the action is scheduled to start\.
7474
*Required*: No
7575
*Type*: Timestamp
7676
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

doc_source/aws-properties-appmesh-virtualnode-listener.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ To declare this entity in your AWS CloudFormation template, use the following sy
1111
```
1212
{
1313
"[HealthCheck](#cfn-appmesh-virtualnode-listener-healthcheck)" : [HealthCheck](aws-properties-appmesh-virtualnode-healthcheck.md),
14-
"[PortMapping](#cfn-appmesh-virtualnode-listener-portmapping)" : [PortMapping](aws-properties-appmesh-virtualnode-portmapping.md)
14+
"[PortMapping](#cfn-appmesh-virtualnode-listener-portmapping)" : [PortMapping](aws-properties-appmesh-virtualnode-portmapping.md),
15+
"[TLS](#cfn-appmesh-virtualnode-listener-tls)" : [ListenerTls](aws-properties-appmesh-virtualnode-listenertls.md)
1516
}
1617
```
1718

@@ -22,6 +23,8 @@ To declare this entity in your AWS CloudFormation template, use the following sy
2223
[HealthCheck](aws-properties-appmesh-virtualnode-healthcheck.md)
2324
[PortMapping](#cfn-appmesh-virtualnode-listener-portmapping):
2425
[PortMapping](aws-properties-appmesh-virtualnode-portmapping.md)
26+
[TLS](#cfn-appmesh-virtualnode-listener-tls):
27+
[ListenerTls](aws-properties-appmesh-virtualnode-listenertls.md)
2528
```
2629

2730
## Properties<a name="aws-properties-appmesh-virtualnode-listener-properties"></a>
@@ -36,4 +39,10 @@ The health check information for the listener\.
3639
The port mapping information for the listener\.
3740
*Required*: Yes
3841
*Type*: [PortMapping](aws-properties-appmesh-virtualnode-portmapping.md)
42+
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
43+
44+
`TLS` <a name="cfn-appmesh-virtualnode-listener-tls"></a>
45+
A reference to an object that represents the Transport Layer Security \(TLS\) properties for a listener\.
46+
*Required*: No
47+
*Type*: [ListenerTls](aws-properties-appmesh-virtualnode-listenertls.md)
3948
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

doc_source/aws-properties-appmesh-virtualnode-virtualnodespec.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ To declare this entity in your AWS CloudFormation template, use the following sy
1010

1111
```
1212
{
13+
"[BackendDefaults](#cfn-appmesh-virtualnode-virtualnodespec-backenddefaults)" : [BackendDefaults](aws-properties-appmesh-virtualnode-backenddefaults.md),
1314
"[Backends](#cfn-appmesh-virtualnode-virtualnodespec-backends)" : [ [Backend](aws-properties-appmesh-virtualnode-backend.md), ... ],
1415
"[Listeners](#cfn-appmesh-virtualnode-virtualnodespec-listeners)" : [ [Listener](aws-properties-appmesh-virtualnode-listener.md), ... ],
1516
"[Logging](#cfn-appmesh-virtualnode-virtualnodespec-logging)" : [Logging](aws-properties-appmesh-virtualnode-logging.md),
@@ -20,6 +21,8 @@ To declare this entity in your AWS CloudFormation template, use the following sy
2021
### YAML<a name="aws-properties-appmesh-virtualnode-virtualnodespec-syntax.yaml"></a>
2122

2223
```
24+
[BackendDefaults](#cfn-appmesh-virtualnode-virtualnodespec-backenddefaults):
25+
[BackendDefaults](aws-properties-appmesh-virtualnode-backenddefaults.md)
2326
[Backends](#cfn-appmesh-virtualnode-virtualnodespec-backends):
2427
- [Backend](aws-properties-appmesh-virtualnode-backend.md)
2528
[Listeners](#cfn-appmesh-virtualnode-virtualnodespec-listeners):
@@ -32,6 +35,12 @@ To declare this entity in your AWS CloudFormation template, use the following sy
3235

3336
## Properties<a name="aws-properties-appmesh-virtualnode-virtualnodespec-properties"></a>
3437

38+
`BackendDefaults` <a name="cfn-appmesh-virtualnode-virtualnodespec-backenddefaults"></a>
39+
A reference to an object that represents the defaults for backends\.
40+
*Required*: No
41+
*Type*: [BackendDefaults](aws-properties-appmesh-virtualnode-backenddefaults.md)
42+
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
43+
3544
`Backends` <a name="cfn-appmesh-virtualnode-virtualnodespec-backends"></a>
3645
The backends that the virtual node is expected to send outbound traffic to\.
3746
*Required*: No

0 commit comments

Comments
 (0)