func ExampleSSM_CancelCommand() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.CancelCommandInput{
CommandId: aws.String("CommandId"), // Required
InstanceIds: []*string{
aws.String("InstanceId"), // Required
// More values...
},
}
resp, err := svc.CancelCommand(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ListAssociations() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.ListAssociationsInput{
AssociationFilterList: []*ssm.AssociationFilter{ // Required
{ // Required
Key: aws.String("AssociationFilterKey"), // Required
Value: aws.String("AssociationFilterValue"), // Required
},
// More values...
},
MaxResults: aws.Int64(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.ListAssociations(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_RemoveTagsFromResource() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.RemoveTagsFromResourceInput{
ResourceId: aws.String("ResourceId"), // Required
ResourceType: aws.String("ResourceTypeForTagging"), // Required
TagKeys: []*string{ // Required
aws.String("TagKey"), // Required
// More values...
},
}
resp, err := svc.RemoveTagsFromResource(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_DescribeDocumentPermission() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.DescribeDocumentPermissionInput{
Name: aws.String("DocumentName"), // Required
PermissionType: aws.String("DocumentPermissionType"), // Required
}
resp, err := svc.DescribeDocumentPermission(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_AddTagsToResource() {
svc := ssm.New(session.New())
params := &ssm.AddTagsToResourceInput{
ResourceId: aws.String("ResourceId"), // Required
ResourceType: aws.String("ResourceTypeForTagging"), // Required
Tags: []*ssm.Tag{ // Required
{ // Required
Key: aws.String("TagKey"), // Required
Value: aws.String("TagValue"), // Required
},
// More values...
},
}
resp, err := svc.AddTagsToResource(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_CreateAssociation() {
svc := ssm.New(session.New())
params := &ssm.CreateAssociationInput{
InstanceId: aws.String("InstanceId"), // Required
Name: aws.String("DocumentName"), // Required
Parameters: map[string][]*string{
"Key": { // Required
aws.String("ParameterValue"), // Required
// More values...
},
// More values...
},
}
resp, err := svc.CreateAssociation(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_DescribeInstanceProperties() {
svc := ssm.New(session.New())
params := &ssm.DescribeInstancePropertiesInput{
InstancePropertyFilterList: []*ssm.InstancePropertyFilter{
{ // Required
Key: aws.String("InstancePropertyFilterKey"), // Required
ValueSet: []*string{ // Required
aws.String("InstancePropertyFilterValue"), // Required
// More values...
},
},
// More values...
},
MaxResults: aws.Int64(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.DescribeInstanceProperties(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ListDocuments() {
svc := ssm.New(session.New())
params := &ssm.ListDocumentsInput{
DocumentFilterList: []*ssm.DocumentFilter{
{ // Required
Key: aws.String("DocumentFilterKey"), // Required
Value: aws.String("DocumentFilterValue"), // Required
},
// More values...
},
MaxResults: aws.Int64(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.ListDocuments(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_DescribeActivations() {
svc := ssm.New(session.New())
params := &ssm.DescribeActivationsInput{
Filters: []*ssm.DescribeActivationsFilter{
{ // Required
FilterKey: aws.String("DescribeActivationsFilterKeys"),
FilterValues: []*string{
aws.String("String"), // Required
// More values...
},
},
// More values...
},
MaxResults: aws.Int64(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.DescribeActivations(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_CreateActivation() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.CreateActivationInput{
IamRole: aws.String("IamRole"), // Required
DefaultInstanceName: aws.String("DefaultInstanceName"),
Description: aws.String("ActivationDescription"),
ExpirationDate: aws.Time(time.Now()),
RegistrationLimit: aws.Int64(1),
}
resp, err := svc.CreateActivation(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_UpdateAssociationStatus() {
svc := ssm.New(session.New())
params := &ssm.UpdateAssociationStatusInput{
AssociationStatus: &ssm.AssociationStatus{ // Required
Date: aws.Time(time.Now()), // Required
Message: aws.String("StatusMessage"), // Required
Name: aws.String("AssociationStatusName"), // Required
AdditionalInfo: aws.String("StatusAdditionalInfo"),
},
InstanceId: aws.String("InstanceId"), // Required
Name: aws.String("DocumentName"), // Required
}
resp, err := svc.UpdateAssociationStatus(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ModifyDocumentPermission() {
svc := ssm.New(session.New())
params := &ssm.ModifyDocumentPermissionInput{
Name: aws.String("DocumentName"), // Required
PermissionType: aws.String("DocumentPermissionType"), // Required
AccountIdsToAdd: []*string{
aws.String("AccountId"), // Required
// More values...
},
AccountIdsToRemove: []*string{
aws.String("AccountId"), // Required
// More values...
},
}
resp, err := svc.ModifyDocumentPermission(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_CreateDocument() {
svc := ssm.New(nil)
params := &ssm.CreateDocumentInput{
Content: aws.String("DocumentContent"), // Required
Name: aws.String("DocumentName"), // Required
}
resp, err := svc.CreateDocument(params)
if err != nil {
if awsErr, ok := err.(awserr.Error); ok {
// Generic AWS error with Code, Message, and original error (if any)
fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr())
if reqErr, ok := err.(awserr.RequestFailure); ok {
// A service error occurred
fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID())
}
} else {
// This case should never be hit, the SDK should always return an
// error which satisfies the awserr.Error interface.
fmt.Println(err.Error())
}
}
// Pretty-print the response data.
fmt.Println(awsutil.StringValue(resp))
}
func ExampleSSM_SendCommand() {
svc := ssm.New(session.New())
params := &ssm.SendCommandInput{
DocumentName: aws.String("DocumentName"), // Required
InstanceIds: []*string{ // Required
aws.String("InstanceId"), // Required
// More values...
},
Comment: aws.String("Comment"),
OutputS3BucketName: aws.String("S3BucketName"),
OutputS3KeyPrefix: aws.String("S3KeyPrefix"),
Parameters: map[string][]*string{
"Key": { // Required
aws.String("ParameterValue"), // Required
// More values...
},
// More values...
},
TimeoutSeconds: aws.Int64(1),
}
resp, err := svc.SendCommand(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ListDocuments() {
svc := ssm.New(nil)
params := &ssm.ListDocumentsInput{
DocumentFilterList: []*ssm.DocumentFilter{
{ // Required
Key: aws.String("DocumentFilterKey"), // Required
Value: aws.String("DocumentFilterValue"), // Required
},
// More values...
},
MaxResults: aws.Long(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.ListDocuments(params)
if err != nil {
if awsErr, ok := err.(awserr.Error); ok {
// Generic AWS error with Code, Message, and original error (if any)
fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr())
if reqErr, ok := err.(awserr.RequestFailure); ok {
// A service error occurred
fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID())
}
} else {
// This case should never be hit, the SDK should always return an
// error which satisfies the awserr.Error interface.
fmt.Println(err.Error())
}
}
// Pretty-print the response data.
fmt.Println(awsutil.StringValue(resp))
}
func ExampleSSM_UpdateAssociationStatus() {
svc := ssm.New(nil)
params := &ssm.UpdateAssociationStatusInput{
AssociationStatus: &ssm.AssociationStatus{ // Required
Date: aws.Time(time.Now()), // Required
Message: aws.String("StatusMessage"), // Required
Name: aws.String("AssociationStatusName"), // Required
AdditionalInfo: aws.String("StatusAdditionalInfo"),
},
InstanceID: aws.String("InstanceId"), // Required
Name: aws.String("DocumentName"), // Required
}
resp, err := svc.UpdateAssociationStatus(params)
if err != nil {
if awsErr, ok := err.(awserr.Error); ok {
// Generic AWS error with Code, Message, and original error (if any)
fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr())
if reqErr, ok := err.(awserr.RequestFailure); ok {
// A service error occurred
fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID())
}
} else {
// This case should never be hit, the SDK should always return an
// error which satisfies the awserr.Error interface.
fmt.Println(err.Error())
}
}
// Pretty-print the response data.
fmt.Println(awsutil.StringValue(resp))
}
func ExampleSSM_UpdateInstanceInformation() {
svc := ssm.New(session.New())
params := &ssm.UpdateInstanceInformationInput{
InstanceId: aws.String("InstanceId"), // Required
AgentStatus: aws.String("AgentStatus"),
AgentVersion: aws.String("Version"),
ComputerName: aws.String("String"),
IPAddress: aws.String("IPAddress"),
PlatformName: aws.String("String"),
PlatformType: aws.String("PlatformType"),
PlatformVersion: aws.String("String"),
}
resp, err := svc.UpdateInstanceInformation(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_CreateAssociationBatch() {
svc := ssm.New(nil)
params := &ssm.CreateAssociationBatchInput{
Entries: []*ssm.CreateAssociationBatchRequestEntry{ // Required
{ // Required
InstanceID: aws.String("InstanceId"),
Name: aws.String("DocumentName"),
},
// More values...
},
}
resp, err := svc.CreateAssociationBatch(params)
if err != nil {
if awsErr, ok := err.(awserr.Error); ok {
// Generic AWS Error with Code, Message, and original error (if any)
fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr())
if reqErr, ok := err.(awserr.RequestFailure); ok {
// A service error occurred
fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID())
}
} else {
// This case should never be hit, the SDK should always return an
// error which satisfies the awserr.Error interface.
fmt.Println(err.Error())
}
}
// Pretty-print the response data.
fmt.Println(awsutil.StringValue(resp))
}
func ExampleSSM_UpdateManagedInstanceRole() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.UpdateManagedInstanceRoleInput{
IamRole: aws.String("IamRole"), // Required
InstanceId: aws.String("ManagedInstanceId"), // Required
}
resp, err := svc.UpdateManagedInstanceRole(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ListCommandInvocations() {
svc := ssm.New(session.New())
params := &ssm.ListCommandInvocationsInput{
CommandId: aws.String("CommandId"),
Details: aws.Bool(true),
Filters: []*ssm.CommandFilter{
{ // Required
Key: aws.String("CommandFilterKey"), // Required
Value: aws.String("CommandFilterValue"), // Required
},
// More values...
},
InstanceId: aws.String("InstanceId"),
MaxResults: aws.Int64(1),
NextToken: aws.String("NextToken"),
}
resp, err := svc.ListCommandInvocations(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
// NewService creates a new SSM service instance.
func NewService() Service {
if ssmStopPolicy == nil {
// create a stop policy where we will stop after 10 consecutive errors and if time period expires.
ssmStopPolicy = sdkutil.NewStopPolicy("ssmService", 10)
}
awsConfig := sdkutil.AwsConfig()
// parse appConfig overrides
appConfig, err := appconfig.Config(false)
if err == nil {
if appConfig.Ssm.Endpoint != "" {
awsConfig.Endpoint = &appConfig.Ssm.Endpoint
}
// TODO: test hook, can be removed before release
// this is to skip ssl verification for the beta self signed certs
if appConfig.Ssm.InsecureSkipVerify {
tr := &http.Transport{
TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
}
awsConfig.HTTPClient = &http.Client{Transport: tr}
}
}
ssmService := ssm.New(session.New(awsConfig))
return &sdkService{sdk: ssmService}
}
func ExampleSSM_SendCommand() {
sess, err := session.NewSession()
if err != nil {
fmt.Println("failed to create session,", err)
return
}
svc := ssm.New(sess)
params := &ssm.SendCommandInput{
DocumentName: aws.String("DocumentARN"), // Required
InstanceIds: []*string{ // Required
aws.String("InstanceId"), // Required
// More values...
},
Comment: aws.String("Comment"),
DocumentHash: aws.String("DocumentHash"),
DocumentHashType: aws.String("DocumentHashType"),
NotificationConfig: &ssm.NotificationConfig{
NotificationArn: aws.String("NotificationArn"),
NotificationEvents: []*string{
aws.String("NotificationEvent"), // Required
// More values...
},
NotificationType: aws.String("NotificationType"),
},
OutputS3BucketName: aws.String("S3BucketName"),
OutputS3KeyPrefix: aws.String("S3KeyPrefix"),
Parameters: map[string][]*string{
"Key": { // Required
aws.String("ParameterValue"), // Required
// More values...
},
// More values...
},
ServiceRoleArn: aws.String("ServiceRole"),
TimeoutSeconds: aws.Int64(1),
}
resp, err := svc.SendCommand(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
// NewRsaService creates a new SSM service instance.
func NewRsaService(serverId string, region string, encodedPrivateKey string) RsaSignedService {
awsConfig := util.AwsConfig()
awsConfig.Region = ®ion
awsConfig.Credentials = credentials.NewStaticCredentials(serverId, encodedPrivateKey, "")
// Create a session to share service client config and handlers with
ssmSess := session.New(awsConfig)
// Clear existing singers
ssmSess.Handlers.Sign.Clear()
// Add custom signer to session, will be used by any service created with this session
ssmSess.Handlers.Sign.PushBack(v4.SignRsa)
ssmService := ssm.New(ssmSess)
return &sdkService{sdk: ssmService}
}
func ExampleSSM_RequestManagedInstanceRoleToken() {
svc := ssm.New(session.New())
params := &ssm.RequestManagedInstanceRoleTokenInput{
Fingerprint: aws.String("Fingerprint"), // Required
}
resp, err := svc.RequestManagedInstanceRoleToken(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_DeregisterManagedInstance() {
svc := ssm.New(session.New())
params := &ssm.DeregisterManagedInstanceInput{
InstanceId: aws.String("ManagedInstanceId"), // Required
}
resp, err := svc.DeregisterManagedInstance(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_GetDocument() {
svc := ssm.New(session.New())
params := &ssm.GetDocumentInput{
Name: aws.String("DocumentARN"), // Required
}
resp, err := svc.GetDocument(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_DescribeAssociation() {
svc := ssm.New(session.New())
params := &ssm.DescribeAssociationInput{
InstanceId: aws.String("InstanceId"), // Required
Name: aws.String("DocumentName"), // Required
}
resp, err := svc.DescribeAssociation(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_UpdateManagedInstancePublicKey() {
svc := ssm.New(session.New())
params := &ssm.UpdateManagedInstancePublicKeyInput{
NewPublicKey: aws.String("PublicKey"), // Required
NewPublicKeyType: aws.String("PublicKeyType"), // Required
}
resp, err := svc.UpdateManagedInstancePublicKey(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_CreateDocument() {
svc := ssm.New(nil)
params := &ssm.CreateDocumentInput{
Content: aws.String("DocumentContent"), // Required
Name: aws.String("DocumentName"), // Required
}
resp, err := svc.CreateDocument(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleSSM_ListTagsForResource() {
svc := ssm.New(session.New())
params := &ssm.ListTagsForResourceInput{
ResourceId: aws.String("ResourceId"), // Required
ResourceType: aws.String("ResourceTypeForTagging"), // Required
}
resp, err := svc.ListTagsForResource(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}