AWS SDK for Go (PILOT)
API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see https://docs.aws.amazon.com/sdk-for-go/api/.

We welcome your feedback on this new version of the documentation. Send your comments to aws-sdkdocs-feedback@amazon.com.

AssociationVersionInfo

import "github.com/aws/aws-sdk-go/service/ssm"

type AssociationVersionInfo struct { AssociationId *string `type:"string"` AssociationName *string `type:"string"` AssociationVersion *string `type:"string"` ComplianceSeverity *string `type:"string" enum:"AssociationComplianceSeverity"` CreatedDate *time.Time `type:"timestamp"` DocumentVersion *string `type:"string"` MaxConcurrency *string `min:"1" type:"string"` MaxErrors *string `min:"1" type:"string"` Name *string `type:"string"` OutputLocation *InstanceAssociationOutputLocation `type:"structure"` Parameters map[string][]*string `type:"map"` ScheduleExpression *string `min:"1" type:"string"` Targets []*Target `type:"list"` }

Information about the association version.

AssociationId

Type: *string

The ID created by the system when the association was created.

AssociationName

Type: *string

The name specified for the association version when the association version was created.

AssociationVersion

Type: *string

The association version.

ComplianceSeverity

Type: *string

The severity level that is assigned to the association.

CreatedDate

Type: *time.Time

The date the association version was created.

DocumentVersion

Type: *string

The version of a Systems Manager document used when the association version was created.

MaxConcurrency

Type: *string

The maximum number of targets allowed to run the association at the same time. You can specify a number, for example 10, or a percentage of the target set, for example 10%. The default value is 100%, which means all targets run the association at the same time.

If a new instance starts and attempts to execute an association while Systems Manager is executing MaxConcurrency associations, the association is allowed to run. During the next association interval, the new instance will process its association within the limit specified for MaxConcurrency.

MaxErrors

Type: *string

The number of errors that are allowed before the system stops sending requests to run the association on additional targets. You can specify either an absolute number of errors, for example 10, or a percentage of the target set, for example 10%. If you specify 3, for example, the system stops sending requests when the fourth error is received. If you specify 0, then the system stops sending requests after the first error is returned. If you run an association on 50 instances and set MaxError to 10%, then the system stops sending the request when the sixth error is received.

Executions that are already running an association when MaxErrors is reached are allowed to complete, but some of these executions may fail as well. If you need to ensure that there won't be more than max-errors failed executions, set MaxConcurrency to 1 so that executions proceed one at a time.

Name

Type: *string

The name specified when the association was created.

OutputLocation

An Amazon S3 bucket where you want to store the results of this request.

Parameters

Type: map[string][]*string

Parameters specified when the association version was created.

ScheduleExpression

Type: *string

The cron or rate schedule specified for the association when the association version was created.

Targets

An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.

Method

GoString

func (s AssociationVersionInfo) GoString() string

GoString returns the string representation

SetAssociationId

func (s *AssociationVersionInfo) SetAssociationId(v string) *AssociationVersionInfo

SetAssociationId sets the AssociationId field's value.

SetAssociationName

func (s *AssociationVersionInfo) SetAssociationName(v string) *AssociationVersionInfo

SetAssociationName sets the AssociationName field's value.

SetAssociationVersion

func (s *AssociationVersionInfo) SetAssociationVersion(v string) *AssociationVersionInfo

SetAssociationVersion sets the AssociationVersion field's value.

SetComplianceSeverity

func (s *AssociationVersionInfo) SetComplianceSeverity(v string) *AssociationVersionInfo

SetComplianceSeverity sets the ComplianceSeverity field's value.

SetCreatedDate

func (s *AssociationVersionInfo) SetCreatedDate(v time.Time) *AssociationVersionInfo

SetCreatedDate sets the CreatedDate field's value.

SetDocumentVersion

func (s *AssociationVersionInfo) SetDocumentVersion(v string) *AssociationVersionInfo

SetDocumentVersion sets the DocumentVersion field's value.

SetMaxConcurrency

func (s *AssociationVersionInfo) SetMaxConcurrency(v string) *AssociationVersionInfo

SetMaxConcurrency sets the MaxConcurrency field's value.

SetMaxErrors

func (s *AssociationVersionInfo) SetMaxErrors(v string) *AssociationVersionInfo

SetMaxErrors sets the MaxErrors field's value.

SetName

func (s *AssociationVersionInfo) SetName(v string) *AssociationVersionInfo

SetName sets the Name field's value.

SetOutputLocation

func (s *AssociationVersionInfo) SetOutputLocation(v *InstanceAssociationOutputLocation) *AssociationVersionInfo

SetOutputLocation sets the OutputLocation field's value.

SetParameters

func (s *AssociationVersionInfo) SetParameters(v map[string][]*string) *AssociationVersionInfo

SetParameters sets the Parameters field's value.

SetScheduleExpression

func (s *AssociationVersionInfo) SetScheduleExpression(v string) *AssociationVersionInfo

SetScheduleExpression sets the ScheduleExpression field's value.

SetTargets

func (s *AssociationVersionInfo) SetTargets(v []*Target) *AssociationVersionInfo

SetTargets sets the Targets field's value.

String

func (s AssociationVersionInfo) String() string

String returns the string representation

On this page: