AWS::SSM::Document AttachmentsSource - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::SSM::Document AttachmentsSource

Identifying information about a document attachment, including the file name and a key-value pair that identifies the location of an attachment to a document.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{ "Key" : String, "Name" : String, "Values" : [ String, ... ] }

YAML

Key: String Name: String Values: - String

Properties

Key

The key of a key-value pair that identifies the location of an attachment to a document.

Required: No

Type: String

Allowed values: SourceUrl | S3FileUrl | AttachmentReference

Update requires: Some interruptions

Name

The name of the document attachment file.

Required: No

Type: String

Pattern: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Minimum: 1

Maximum: 128

Update requires: Some interruptions

Values

The value of a key-value pair that identifies the location of an attachment to a document. The format for Value depends on the type of key you specify.

  • For the key SourceUrl, the value is an S3 bucket location. For example:

    "Values": [ "s3://doc-example-bucket/my-folder" ]

  • For the key S3FileUrl, the value is a file in an S3 bucket. For example:

    "Values": [ "s3://doc-example-bucket/my-folder/my-file.py" ]

  • For the key AttachmentReference, the value is constructed from the name of another SSM document in your account, a version number of that document, and a file attached to that document version that you want to reuse. For example:

    "Values": [ "MyOtherDocument/3/my-other-file.py" ]

    However, if the SSM document is shared with you from another account, the full SSM document ARN must be specified instead of the document name only. For example:

    "Values": [ "arn:aws:ssm:us-east-2:111122223333:document/OtherAccountDocument/3/their-file.py" ]

Required: No

Type: Array of String

Minimum: 1 | 1

Maximum: 100000 | 1

Update requires: Some interruptions