1// Code generated by smithy-go-codegen DO NOT EDIT.
2
3package iam
4
5import (
6	"context"
7	awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
8	"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
9	"github.com/aws/smithy-go/middleware"
10	smithyhttp "github.com/aws/smithy-go/transport/http"
11)
12
13// Attaches the specified managed policy to the specified user. You use this API to
14// attach a managed policy to a user. To embed an inline policy in a user, use
15// PutUserPolicy. For more information about policies, see Managed Policies and
16// Inline Policies
17// (https://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html)
18// in the IAM User Guide.
19func (c *Client) AttachUserPolicy(ctx context.Context, params *AttachUserPolicyInput, optFns ...func(*Options)) (*AttachUserPolicyOutput, error) {
20	if params == nil {
21		params = &AttachUserPolicyInput{}
22	}
23
24	result, metadata, err := c.invokeOperation(ctx, "AttachUserPolicy", params, optFns, addOperationAttachUserPolicyMiddlewares)
25	if err != nil {
26		return nil, err
27	}
28
29	out := result.(*AttachUserPolicyOutput)
30	out.ResultMetadata = metadata
31	return out, nil
32}
33
34type AttachUserPolicyInput struct {
35
36	// The Amazon Resource Name (ARN) of the IAM policy you want to attach. For more
37	// information about ARNs, see Amazon Resource Names (ARNs) and AWS Service
38	// Namespaces
39	// (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in
40	// the AWS General Reference.
41	//
42	// This member is required.
43	PolicyArn *string
44
45	// The name (friendly name, not ARN) of the IAM user to attach the policy to. This
46	// parameter allows (through its regex pattern (http://wikipedia.org/wiki/regex)) a
47	// string of characters consisting of upper and lowercase alphanumeric characters
48	// with no spaces. You can also include any of the following characters: _+=,.@-
49	//
50	// This member is required.
51	UserName *string
52}
53
54type AttachUserPolicyOutput struct {
55	// Metadata pertaining to the operation's result.
56	ResultMetadata middleware.Metadata
57}
58
59func addOperationAttachUserPolicyMiddlewares(stack *middleware.Stack, options Options) (err error) {
60	err = stack.Serialize.Add(&awsAwsquery_serializeOpAttachUserPolicy{}, middleware.After)
61	if err != nil {
62		return err
63	}
64	err = stack.Deserialize.Add(&awsAwsquery_deserializeOpAttachUserPolicy{}, middleware.After)
65	if err != nil {
66		return err
67	}
68	if err = addSetLoggerMiddleware(stack, options); err != nil {
69		return err
70	}
71	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
72		return err
73	}
74	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
75		return err
76	}
77	if err = addResolveEndpointMiddleware(stack, options); err != nil {
78		return err
79	}
80	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
81		return err
82	}
83	if err = addRetryMiddlewares(stack, options); err != nil {
84		return err
85	}
86	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
87		return err
88	}
89	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
90		return err
91	}
92	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
93		return err
94	}
95	if err = addClientUserAgent(stack); err != nil {
96		return err
97	}
98	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
99		return err
100	}
101	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
102		return err
103	}
104	if err = addOpAttachUserPolicyValidationMiddleware(stack); err != nil {
105		return err
106	}
107	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opAttachUserPolicy(options.Region), middleware.Before); err != nil {
108		return err
109	}
110	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
111		return err
112	}
113	if err = addResponseErrorMiddleware(stack); err != nil {
114		return err
115	}
116	if err = addRequestResponseLogging(stack, options); err != nil {
117		return err
118	}
119	return nil
120}
121
122func newServiceMetadataMiddleware_opAttachUserPolicy(region string) *awsmiddleware.RegisterServiceMetadata {
123	return &awsmiddleware.RegisterServiceMetadata{
124		Region:        region,
125		ServiceID:     ServiceID,
126		SigningName:   "iam",
127		OperationName: "AttachUserPolicy",
128	}
129}
130