Client
cloudformation | R Documentation |
AWS CloudFormation¶
Description¶
CloudFormation
CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments predictably and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly reliable, highly scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services infrastructure.
With CloudFormation, you declare all your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.
For more information about CloudFormation, see the CloudFormation product page.
CloudFormation makes use of other Amazon Web Services products. If you need additional technical information about a specific Amazon Web Services product, you can find the product's technical documentation at docs.aws.amazon.com.
Usage¶
Arguments¶
config
Optional configuration of credentials, endpoint, and/or region.
credentials:
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint: The complete URL to use for the constructed client.
region: The AWS Region used in instantiating the client.
close_connection: Immediately close all HTTP connections.
timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
s3_force_path_style: Set this to
true
to force the request to use path-style addressing, i.e.http://s3.amazonaws.com/BUCKET/KEY
.sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials
Optional credentials shorthand for the config parameter
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint
Optional shorthand for complete URL to use for the constructed client.
region
Optional shorthand for AWS Region used in instantiating the client.
Value¶
A client for the service. You can call the service's operations using
syntax like svc$operation(...)
, where svc
is the name you've
assigned to the client. The available operations are listed in the
Operations section.
Service syntax¶
svc <- cloudformation(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical",
sts_regional_endpoint = "string"
),
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string"
)
Operations¶
- activate_organizations_access
- Activate trusted access with Organizations
- activate_type
- Activates a public third-party extension, making it available for use in stack templates
- batch_describe_type_configurations
- Returns configuration data for the specified CloudFormation extensions, from the CloudFormation registry for the account and Region
- cancel_update_stack
- Cancels an update on the specified stack
- continue_update_rollback
- For a specified stack that's in the UPDATE_ROLLBACK_FAILED state, continues rolling it back to the UPDATE_ROLLBACK_COMPLETE state
- create_change_set
- Creates a list of changes that will be applied to a stack so that you can review the changes before executing them
- create_generated_template
- Creates a template from existing resources that are not already managed with CloudFormation
- create_stack
- Creates a stack as specified in the template
- create_stack_instances
- Creates stack instances for the specified accounts, within the specified Amazon Web Services Regions
- create_stack_set
- Creates a stack set
- deactivate_organizations_access
- Deactivates trusted access with Organizations
- deactivate_type
- Deactivates a public extension that was previously activated in this account and Region
- delete_change_set
- Deletes the specified change set
- delete_generated_template
- Deleted a generated template
- delete_stack
- Deletes a specified stack
- delete_stack_instances
- Deletes stack instances for the specified accounts, in the specified Amazon Web Services Regions
- delete_stack_set
- Deletes a stack set
- deregister_type
- Marks an extension or extension version as DEPRECATED in the CloudFormation registry, removing it from active use
- describe_account_limits
- Retrieves your account's CloudFormation limits, such as the maximum number of stacks that you can create in your account
- describe_change_set
- Returns the inputs for the change set and a list of changes that CloudFormation will make if you execute the change set
- describe_change_set_hooks
- Returns hook-related information for the change set and a list of changes that CloudFormation makes when you run the change set
- describe_generated_template
- Describes a generated template
- describe_organizations_access
- Retrieves information about the account's OrganizationAccess status
- describe_publisher
- Returns information about a CloudFormation extension publisher
- describe_resource_scan
- Describes details of a resource scan
- describe_stack_drift_detection_status
- Returns information about a stack drift detection operation
- describe_stack_events
- Returns all stack related events for a specified stack in reverse chronological order
- describe_stack_instance
- Returns the stack instance that's associated with the specified StackSet, Amazon Web Services account, and Amazon Web Services Region
- describe_stack_resource
- Returns a description of the specified resource in the specified stack
- describe_stack_resource_drifts
- Returns drift information for the resources that have been checked for drift in the specified stack
- describe_stack_resources
- Returns Amazon Web Services resource descriptions for running and deleted stacks
- describe_stacks
- Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created
- describe_stack_set
- Returns the description of the specified StackSet
- describe_stack_set_operation
- Returns the description of the specified StackSet operation
- describe_type
- Returns detailed information about an extension that has been registered
- describe_type_registration
- Returns information about an extension's registration, including its current status and type and version identifiers
- detect_stack_drift
- Detects whether a stack's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters
- detect_stack_resource_drift
- Returns information about whether a resource's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters
- detect_stack_set_drift
- Detect drift on a stack set
- estimate_template_cost
- Returns the estimated monthly cost of a template
- execute_change_set
- Updates a stack using the input information that was provided when the specified change set was created
- get_generated_template
- Retrieves a generated template
- get_stack_policy
- Returns the stack policy for a specified stack
- get_template
- Returns the template body for a specified stack
- get_template_summary
- Returns information about a new or existing template
- import_stacks_to_stack_set
- Import existing stacks into a new stack sets
- list_change_sets
- Returns the ID and status of each active change set for a stack
- list_exports
- Lists all exported output values in the account and Region in which you call this action
- list_generated_templates
- Lists your generated templates in this Region
- list_imports
- Lists all stacks that are importing an exported output value
- list_resource_scan_related_resources
- Lists the related resources for a list of resources from a resource scan
- list_resource_scan_resources
- Lists the resources from a resource scan
- list_resource_scans
- List the resource scans from newest to oldest
- list_stack_instance_resource_drifts
- Returns drift information for resources in a stack instance
- list_stack_instances
- Returns summary information about stack instances that are associated with the specified stack set
- list_stack_resources
- Returns descriptions of all resources of the specified stack
- list_stacks
- Returns the summary information for stacks whose status matches the specified StackStatusFilter
- Returns summary information about deployment targets for a stack set
- list_stack_set_operation_results
- Returns summary information about the results of a stack set operation
- list_stack_set_operations
- Returns summary information about operations performed on a stack set
- list_stack_sets
- Returns summary information about stack sets that are associated with the user
- list_type_registrations
- Returns a list of registration tokens for the specified extension(s)
- list_types
- Returns summary information about extension that have been registered with CloudFormation
- list_type_versions
- Returns summary information about the versions of an extension
- publish_type
- Publishes the specified extension to the CloudFormation registry as a public extension in this Region
- record_handler_progress
- Reports progress of a resource handler to CloudFormation
- register_publisher
- Registers your account as a publisher of public extensions in the CloudFormation registry
- register_type
- Registers an extension with the CloudFormation service
- rollback_stack
- When specifying RollbackStack, you preserve the state of previously provisioned resources when an operation fails
- set_stack_policy
- Sets a stack policy for a specified stack
- set_type_configuration
- Specifies the configuration data for a registered CloudFormation extension, in the given account and Region
- set_type_default_version
- Specify the default version of an extension
- signal_resource
- Sends a signal to the specified resource with a success or failure status
- start_resource_scan
- Starts a scan of the resources in this account in this Region
- stop_stack_set_operation
- Stops an in-progress operation on a stack set and its associated stack instances
- test_type
- Tests a registered extension to make sure it meets all necessary requirements for being published in the CloudFormation registry
- update_generated_template
- Updates a generated template
- update_stack
- Updates a stack as specified in the template
- update_stack_instances
- Updates the parameter values for stack instances for the specified accounts, within the specified Amazon Web Services Regions
- update_stack_set
- Updates the stack set, and associated stack instances in the specified accounts and Amazon Web Services Regions
- update_termination_protection
- Updates termination protection for the specified stack
- validate_template
- Validates a specified template
Examples¶
## Not run:
svc <- cloudformation()
# This example creates a generated template with a resources file.
svc$create_generated_template(
GeneratedTemplateName = "JazzyTemplate",
Resources = list(
list(
ResourceIdentifier = list(
BucketName = "jazz-bucket"
),
ResourceType = "AWS::S3::Bucket"
),
list(
ResourceIdentifier = list(
DhcpOptionsId = "random-id123"
),
ResourceType = "AWS::EC2::DHCPOptions"
)
)
)
## End(Not run)