5.2.4 Stack information list
Function
This plugin outputs an information list of stacks managed in an AWS CloudFormation environment to a CSV file on an AWS control server (execution target server).
The character encoding of the output file is the default encoding of the system on the AWS control server (execution target server).
This plugin assumes the following server:
- AWS control server (execution target server)
A server on which AWS Tools for Windows PowerShell (abbreviated hereafter to "AWS Tools") is installed. AWS Tools transfers the plugin to, and executes it on, this server.
The script within this plugin executes the following AWS Tools commandlet:
- Get-CFNStack
For details about AWS Tools commandlets, see the AWS document "AWS Tools for Windows PowerShell Cmdlet Reference".
The items in a CSV file that is output are shown below.
Each item is output, separated by a comma.
(a) Stack name (Header name: StackName)
(b) Stack creation time (Header name: CreatedTime)
(c) Stack status (Header name: Status)
(d) Stack description (Header name: Description)
Use situation
This plugin can be used to obtain information about stacks managed in an AWS CloudFormation environment.
Prerequisites
For the latest support information about [Required products for the service template execution server], and [Prerequisite OS for the required products for the service template execution server], see the Release Notes.
In addition, the following OS and products use abbreviations. For the abbreviations of OS and products, see the "Preface".
[Required products for the service template execution server]
- AWS Tools for Windows PowerShell
- Microsoft .Net Framework 3.5 or later
[Prerequisite OS for the required products for the service template execution server]
- Windows Server
Cautions
(1) Do not specify character strings containing double quotation marks (") or single quotation marks (') in the properties of this plugin.
(2) If the file specified in the AWS.stackInfoListOutputFileName property (the output file name of a stack information list) already exists, the existing file will be overwritten. Therefore, make sure that the specified file name is correct.
(3) Create any missing folders that are included in the path to the file to be created.
(4) For other notes, see the notes in the AWS document "AWS Tools for Windows PowerShell Cmdlet Reference".
Execution privilege
(1) Policies must be set up so that IAM users logging in to AWS can perform the following action:
- Obtaining stack information
Version
02.01.00
Plug-in tags
Gather VM information,AWS
Plug-in name displayed in the task log
awsOutputStackSpec
Return code
0: Normal
12: Error (User error) Invalid property
23: Error (Invalid environment) Required environment is invalid
27: Error (Check task logs for the nature of error)
41: Error (Error detected in plugin) Missing property (Error detected in plugin script)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
AWS.accessKeyId |
Access key ID |
Specify the access key ID for connecting to AWS. |
-- |
Input |
R |
AWS.secretAccessKey |
Secret access key |
Specify the secret access key for connecting to AWS. |
-- |
Input |
R |
AWS.region |
Region |
Specify an AWS region that is a connection destination. |
-- |
Input |
R |
AWS.stackInfoListOutputFileName |
Stack information listing file name |
Specify a file, as a full path name, where stack information is to be listed. |
-- |
Input |
R |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |