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// Changes the password of the IAM user who is calling this operation. This
14// operation can be performed using the AWS CLI, the AWS API, or the My Security
15// Credentials page in the AWS Management Console. The AWS account root user
16// password is not affected by this operation. Use UpdateLoginProfile to use the
17// AWS CLI, the AWS API, or the Users page in the IAM console to change the
18// password for any IAM user. For more information about modifying passwords, see
19// Managing passwords
20// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html) in
21// the IAM User Guide.
22func (c *Client) ChangePassword(ctx context.Context, params *ChangePasswordInput, optFns ...func(*Options)) (*ChangePasswordOutput, error) {
23	if params == nil {
24		params = &ChangePasswordInput{}
25	}
26
27	result, metadata, err := c.invokeOperation(ctx, "ChangePassword", params, optFns, addOperationChangePasswordMiddlewares)
28	if err != nil {
29		return nil, err
30	}
31
32	out := result.(*ChangePasswordOutput)
33	out.ResultMetadata = metadata
34	return out, nil
35}
36
37type ChangePasswordInput struct {
38
39	// The new password. The new password must conform to the AWS account's password
40	// policy, if one exists. The regex pattern (http://wikipedia.org/wiki/regex) that
41	// is used to validate this parameter is a string of characters. That string can
42	// include almost any printable ASCII character from the space (\u0020) through the
43	// end of the ASCII character range (\u00FF). You can also include the tab
44	// (\u0009), line feed (\u000A), and carriage return (\u000D) characters. Any of
45	// these characters are valid in a password. However, many tools, such as the AWS
46	// Management Console, might restrict the ability to type certain characters
47	// because they have special meaning within that tool.
48	//
49	// This member is required.
50	NewPassword *string
51
52	// The IAM user's current password.
53	//
54	// This member is required.
55	OldPassword *string
56}
57
58type ChangePasswordOutput struct {
59	// Metadata pertaining to the operation's result.
60	ResultMetadata middleware.Metadata
61}
62
63func addOperationChangePasswordMiddlewares(stack *middleware.Stack, options Options) (err error) {
64	err = stack.Serialize.Add(&awsAwsquery_serializeOpChangePassword{}, middleware.After)
65	if err != nil {
66		return err
67	}
68	err = stack.Deserialize.Add(&awsAwsquery_deserializeOpChangePassword{}, middleware.After)
69	if err != nil {
70		return err
71	}
72	if err = addSetLoggerMiddleware(stack, options); err != nil {
73		return err
74	}
75	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
76		return err
77	}
78	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
79		return err
80	}
81	if err = addResolveEndpointMiddleware(stack, options); err != nil {
82		return err
83	}
84	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
85		return err
86	}
87	if err = addRetryMiddlewares(stack, options); err != nil {
88		return err
89	}
90	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
91		return err
92	}
93	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
94		return err
95	}
96	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
97		return err
98	}
99	if err = addClientUserAgent(stack); err != nil {
100		return err
101	}
102	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
103		return err
104	}
105	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
106		return err
107	}
108	if err = addOpChangePasswordValidationMiddleware(stack); err != nil {
109		return err
110	}
111	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opChangePassword(options.Region), middleware.Before); err != nil {
112		return err
113	}
114	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
115		return err
116	}
117	if err = addResponseErrorMiddleware(stack); err != nil {
118		return err
119	}
120	if err = addRequestResponseLogging(stack, options); err != nil {
121		return err
122	}
123	return nil
124}
125
126func newServiceMetadataMiddleware_opChangePassword(region string) *awsmiddleware.RegisterServiceMetadata {
127	return &awsmiddleware.RegisterServiceMetadata{
128		Region:        region,
129		ServiceID:     ServiceID,
130		SigningName:   "iam",
131		OperationName: "ChangePassword",
132	}
133}
134