AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the CreateAssociation operation. Associates the specified Systems Manager document with the specified instances or targets.

When you associate a document with one or more instances using instance IDs or tags, the SSM Agent running on the instance processes the document and configures the instance as specified.

If you associate a document with an instance that already has an associated document, the system throws the AssociationAlreadyExists exception.

Inheritance Hierarchy


Namespace: Amazon.SimpleSystemsManagement.Model
Assembly: AWSSDK.SimpleSystemsManagement.dll
Version: 3.x.y.z


public class CreateAssociationRequest : AmazonSimpleSystemsManagementRequest

The CreateAssociationRequest type exposes the following members


Public Method CreateAssociationRequest()

Empty constructor used to set properties independently even when a simple constructor is available

Public Method CreateAssociationRequest(string, string)

Instantiates CreateAssociationRequest with the parameterized properties


Public Property AssociationName System.String

Gets and sets the property AssociationName.

Specify a descriptive name for the association.

Public Property DocumentVersion System.String

Gets and sets the property DocumentVersion.

The document version you want to associate with the target(s). Can be a specific version or the default version.

Public Property InstanceId System.String

Gets and sets the property InstanceId.

The instance ID.

Public Property Name System.String

Gets and sets the property Name.

The name of the Systems Manager document.

Public Property OutputLocation Amazon.SimpleSystemsManagement.Model.InstanceAssociationOutputLocation

Gets and sets the property OutputLocation.

An Amazon S3 bucket where you want to store the output details of the request.

Public Property Parameters System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>>

Gets and sets the property Parameters.

The parameters for the documents runtime configuration.

Public Property ScheduleExpression System.String

Gets and sets the property ScheduleExpression.

A cron expression when the association will be applied to the target(s).

Public Property Targets System.Collections.Generic.List<Amazon.SimpleSystemsManagement.Model.Target>

Gets and sets the property Targets.

The targets (either instances or tags) for the association.

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms