AWS Systems Manager Connector

Latest Dynatrace

Review the required AWS permissions and condition keys of the AWS Systems Manager Connector actions to ensure that you grant Dynatrace only a minimum set of permissions. For more information, see AWS documentation.

Describe Automation Executions

Provides details about all active and terminated Automation executions.

For more information, see the official documentation of Describe Automation Executions.

Required AWS permission: ssm:DescribeAutomationExecutions.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filters
AutomationExecutionFilter[]
Filters used to limit the scope of executions that are requested.
optional

Output

Returns fields as described in DescribeAutomationExecutionsCommandOutput.

Describe Document

Describes the specified Amazon Web Services Systems Manager document (SSM document).

For more information, see the official documentation of Describe Document.

Required AWS permission: ssm:DescribeDocument.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Name
string
The name of the SSM document.
required
DocumentVersion
string
The document version for which you want information.
optional
VersionName
string
An optional field specifying the version of the artifact associated with the document.
optional

Output

Returns fields as described in DescribeDocumentCommandOutput.

Get Automation Execution

Get detailed information about a particular Automation execution.

For more information, see the official documentation of Get Automation Execution.

Required AWS permission: ssm:GetAutomationExecution.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutomationExecutionId
string
The unique identifier for an existing automation execution to examine.
required

Output

Returns fields as described in GetAutomationExecutionCommandOutput.

Get Document

Gets the contents of the specified Amazon Web Services Systems Manager document (SSM document).

For more information, see the official documentation of Get Document.

Required AWS permission: ssm:GetDocument.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Name
string
The name of the SSM document.
required
DocumentFormat
DocumentFormat
Returns the document in the specified format.
optional
DocumentVersion
string
The document version for which you want information.
optional
VersionName
string
An optional field specifying the version of the artifact associated with the document.
optional

Output

Returns fields as described in GetDocumentCommandOutput.

List Documents

Returns all Systems Manager (SSM) documents in the current Amazon Web Services account and Amazon Web Services Region.

For more information, see the official documentation of List Documents.

Required AWS permission: ssm:ListDocuments.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filters
DocumentKeyValuesFilter[]
One or more DocumentKeyValuesFilter objects.
optional
MaxResults
number
The maximum number of items to return for this call.
optional

Output

Returns fields as described in ListDocumentsCommandOutput.

Put Parameter

Add a parameter to the system.

For more information, see the official documentation of Put Parameter.

Required AWS permission: ssm:PutParameter.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Name
string
The fully qualified name of the parameter that you want to add to the system.
required
Value
string
The parameter value that you want to add to the system.
required
AllowedPattern
string
A regular expression used to validate the parameter value.
optional
DataType
string
The data type for a String parameter.
optional
Description
string
Information about the parameter that you want to add to the system.
optional
KeyId
string
The Key Management Service (KMS) ID that you want to use to encrypt a parameter.
optional
Overwrite
boolean
Overwrite an existing parameter.
optional
Policies
string
One or more policies to apply to a parameter.
optional
Tags
Tag[]
Optional metadata that you assign to a resource.
optional
Tier
ParameterTier
The parameter tier to assign to a parameter.
optional
Type
ParameterType
The type of parameter that you want to add to the system.
optional

Output

Returns fields as described in PutParameterCommandOutput.

Start Automation Execution

Initiates execution of an Automation runbook.

For more information, see the official documentation of Start Automation Execution.

Required AWS permission: ssm:StartAutomationExecution.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
DocumentName
string
The name of the SSM document to run.
required
AlarmConfiguration
AlarmConfiguration
The CloudWatch alarm you want to apply to your automation.
optional
ClientToken
string
User-provided idempotency token.
optional
DocumentVersion
string
The version of the Automation runbook to use for this execution.
optional
MaxConcurrency
string
The maximum number of targets allowed to run this task in parallel.
optional
MaxErrors
string
The number of errors that are allowed before the system stops running the automation on additional targets.
optional
Mode
ExecutionMode
The execution mode of the automation.
optional
Parameters
Record<string, string[]>
A key-value map of execution parameters, which match the declared parameters in the Automation runbook.
optional
Tags
Tag[]
Optional metadata that you assign to a resource.
optional
TargetLocations
TargetLocation[]
A location is a combination of Amazon Web Services Regions and/or Amazon Web Services accounts where you want to run the automation.
optional
TargetLocationsURL
string
Specify a publicly accessible URL for a file that contains the TargetLocations body.
optional
TargetMaps
Record<string, string[]>[]
A key-value mapping of document parameters to target resources.
optional
TargetParameterName
string
The name of the parameter used as the target resource for the rate-controlled execution.
optional
Targets
Target[]
A key-value mapping to target resources.
optional

Output

Returns fields as described in StartAutomationExecutionCommandOutput.

Stop Automation Execution

Stop an Automation that is currently running.

For more information, see the official documentation of Stop Automation Execution.

Required AWS permission: ssm:StopAutomationExecution.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutomationExecutionId
string
The execution ID of the Automation to stop.
required
Type
StopType
The stop request type.
optional

Output

Returns fields as described in StopAutomationExecutionCommandOutput.