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
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package detective
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/detective/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// CreateMembers is used to send invitations to accounts. For the organization
// behavior graph, the Detective administrator account uses CreateMembers to
// enable organization accounts as member accounts. For invited accounts,
// CreateMembers sends a request to invite the specified Amazon Web Services
// accounts to be member accounts in the behavior graph. This operation can only be
// called by the administrator account for a behavior graph. CreateMembers
// verifies the accounts and then invites the verified accounts. The administrator
// can optionally specify to not send invitation emails to the member accounts.
// This would be used when the administrator manages their member accounts
// centrally. For organization accounts in the organization behavior graph,
// CreateMembers attempts to enable the accounts. The organization accounts do not
// receive invitations. The request provides the behavior graph ARN and the list of
// accounts to invite or to enable. The response separates the requested accounts
// into two lists:
// - The accounts that CreateMembers was able to process. For invited accounts,
// includes member accounts that are being verified, that have passed verification
// and are to be invited, and that have failed verification. For organization
// accounts in the organization behavior graph, includes accounts that can be
// enabled and that cannot be enabled.
// - The accounts that CreateMembers was unable to process. This list includes
// accounts that were already invited to be member accounts in the behavior graph.
func (c *Client) CreateMembers(ctx context.Context, params *CreateMembersInput, optFns ...func(*Options)) (*CreateMembersOutput, error) {
if params == nil {
params = &CreateMembersInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateMembers", params, optFns, c.addOperationCreateMembersMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateMembersOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateMembersInput struct {
// The list of Amazon Web Services accounts to invite or to enable. You can invite
// or enable up to 50 accounts at a time. For each invited account, the account
// list contains the account identifier and the Amazon Web Services account root
// user email address. For organization accounts in the organization behavior
// graph, the email address is not required.
//
// This member is required.
Accounts []types.Account
// The ARN of the behavior graph.
//
// This member is required.
GraphArn *string
// if set to true , then the invited accounts do not receive email notifications.
// By default, this is set to false , and the invited accounts receive email
// notifications. Organization accounts in the organization behavior graph do not
// receive email notifications.
DisableEmailNotification bool
// Customized message text to include in the invitation email message to the
// invited member accounts.
Message *string
noSmithyDocumentSerde
}
type CreateMembersOutput struct {
// The set of member account invitation or enablement requests that Detective was
// able to process. This includes accounts that are being verified, that failed
// verification, and that passed verification and are being sent an invitation or
// are being enabled.
Members []types.MemberDetail
// The list of accounts for which Detective was unable to process the invitation
// or enablement request. For each account, the list provides the reason why the
// request could not be processed. The list includes accounts that are already
// member accounts in the behavior graph.
UnprocessedAccounts []types.UnprocessedAccount
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateMembersMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsRestjson1_serializeOpCreateMembers{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsRestjson1_deserializeOpCreateMembers{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "CreateMembers"); 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 = addOpCreateMembersValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateMembers(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_opCreateMembers(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "CreateMembers",
}
}
|
