1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package ssm
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
"github.com/aws/aws-sdk-go-v2/service/ssm/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
"time"
)
// Generates an activation code and activation ID you can use to register your
// on-premises servers, edge devices, or virtual machine (VM) with Amazon Web
// Services Systems Manager. Registering these machines with Systems Manager makes
// it possible to manage them using Systems Manager capabilities. You use the
// activation code and ID when installing SSM Agent on machines in your hybrid
// environment. For more information about requirements for managing on-premises
// machines using Systems Manager, see Setting up Amazon Web Services Systems
// Manager for hybrid environments (https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html)
// in the Amazon Web Services Systems Manager User Guide. Amazon Elastic Compute
// Cloud (Amazon EC2) instances, edge devices, and on-premises servers and VMs that
// are configured for Systems Manager are all called managed nodes.
func (c *Client) CreateActivation(ctx context.Context, params *CreateActivationInput, optFns ...func(*Options)) (*CreateActivationOutput, error) {
if params == nil {
params = &CreateActivationInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateActivation", params, optFns, c.addOperationCreateActivationMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateActivationOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateActivationInput struct {
// The name of the Identity and Access Management (IAM) role that you want to
// assign to the managed node. This IAM role must provide AssumeRole permissions
// for the Amazon Web Services Systems Manager service principal ssm.amazonaws.com
// . For more information, see Create an IAM service role for a hybrid environment (https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html)
// in the Amazon Web Services Systems Manager User Guide. You can't specify an IAM
// service-linked role for this parameter. You must create a unique role.
//
// This member is required.
IamRole *string
// The name of the registered, managed node as it will appear in the Amazon Web
// Services Systems Manager console or when you use the Amazon Web Services command
// line tools to list Systems Manager resources. Don't enter personally
// identifiable information in this field.
DefaultInstanceName *string
// A user-defined description of the resource that you want to register with
// Systems Manager. Don't enter personally identifiable information in this field.
Description *string
// The date by which this activation request should expire, in timestamp format,
// such as "2021-07-07T00:00:00". You can specify a date up to 30 days in advance.
// If you don't provide an expiration date, the activation code expires in 24
// hours.
ExpirationDate *time.Time
// Specify the maximum number of managed nodes you want to register. The default
// value is 1 .
RegistrationLimit *int32
// Reserved for internal use.
RegistrationMetadata []types.RegistrationMetadataItem
// Optional metadata that you assign to a resource. Tags enable you to categorize
// a resource in different ways, such as by purpose, owner, or environment. For
// example, you might want to tag an activation to identify which servers or
// virtual machines (VMs) in your on-premises environment you intend to activate.
// In this case, you could specify the following key-value pairs:
// - Key=OS,Value=Windows
// - Key=Environment,Value=Production
// When you install SSM Agent on your on-premises servers and VMs, you specify an
// activation ID and code. When you specify the activation ID and code, tags
// assigned to the activation are automatically applied to the on-premises servers
// or VMs. You can't add tags to or delete tags from an existing activation. You
// can tag your on-premises servers, edge devices, and VMs after they connect to
// Systems Manager for the first time and are assigned a managed node ID. This
// means they are listed in the Amazon Web Services Systems Manager console with an
// ID that is prefixed with "mi-". For information about how to add tags to your
// managed nodes, see AddTagsToResource . For information about how to remove tags
// from your managed nodes, see RemoveTagsFromResource .
Tags []types.Tag
noSmithyDocumentSerde
}
type CreateActivationOutput struct {
// The code the system generates when it processes the activation. The activation
// code functions like a password to validate the activation ID.
ActivationCode *string
// The ID number generated by the system when it processed the activation. The
// activation ID functions like a user name.
ActivationId *string
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateActivationMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateActivation{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateActivation{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "CreateActivation"); err != nil {
return fmt.Errorf("add protocol finalizers: %v", err)
}
if err = addlegacyEndpointContextSetter(stack, options); err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
return err
}
if err = addRetryMiddlewares(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
return err
}
if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack, options); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil {
return err
}
if err = addOpCreateActivationValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateActivation(options.Region), middleware.Before); err != nil {
return err
}
if err = awsmiddleware.AddRecursionDetection(stack); err != nil {
return err
}
if err = addRequestIDRetrieverMiddleware(stack); err != nil {
return err
}
if err = addResponseErrorMiddleware(stack); err != nil {
return err
}
if err = addRequestResponseLogging(stack, options); err != nil {
return err
}
if err = addDisableHTTPSMiddleware(stack, options); err != nil {
return err
}
return nil
}
func newServiceMetadataMiddleware_opCreateActivation(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "CreateActivation",
}
}
|
