/**
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
* SPDX-License-Identifier: Apache-2.0.
*/
#pragma once
#include
#include
#include
#include
#include
#include
#include
namespace Aws
{
namespace CognitoIdentityProvider
{
namespace Model
{
/**
* Represents the request to update the user's attributes as an
* administrator.
See Also:
AWS
* API Reference
*/
class AdminUpdateUserAttributesRequest : public CognitoIdentityProviderRequest
{
public:
AWS_COGNITOIDENTITYPROVIDER_API AdminUpdateUserAttributesRequest();
// Service request name is the Operation name which will send this request out,
// each operation should has unique request name, so that we can get operation's name from this request.
// Note: this is not true for response, multiple operations may have the same response name,
// so we can not get operation's name from response.
inline virtual const char* GetServiceRequestName() const override { return "AdminUpdateUserAttributes"; }
AWS_COGNITOIDENTITYPROVIDER_API Aws::String SerializePayload() const override;
AWS_COGNITOIDENTITYPROVIDER_API Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override;
///@{
/**
* The user pool ID for the user pool where you want to update user
* attributes.
*/
inline const Aws::String& GetUserPoolId() const{ return m_userPoolId; }
inline bool UserPoolIdHasBeenSet() const { return m_userPoolIdHasBeenSet; }
inline void SetUserPoolId(const Aws::String& value) { m_userPoolIdHasBeenSet = true; m_userPoolId = value; }
inline void SetUserPoolId(Aws::String&& value) { m_userPoolIdHasBeenSet = true; m_userPoolId = std::move(value); }
inline void SetUserPoolId(const char* value) { m_userPoolIdHasBeenSet = true; m_userPoolId.assign(value); }
inline AdminUpdateUserAttributesRequest& WithUserPoolId(const Aws::String& value) { SetUserPoolId(value); return *this;}
inline AdminUpdateUserAttributesRequest& WithUserPoolId(Aws::String&& value) { SetUserPoolId(std::move(value)); return *this;}
inline AdminUpdateUserAttributesRequest& WithUserPoolId(const char* value) { SetUserPoolId(value); return *this;}
///@}
///@{
/**
* The username of the user that you want to query or modify. The value of this
* parameter is typically your user's username, but it can be any of their alias
* attributes. If username isn't an alias attribute in your user pool,
* this value must be the sub of a local user or the username of a
* user from a third-party IdP.
*/
inline const Aws::String& GetUsername() const{ return m_username; }
inline bool UsernameHasBeenSet() const { return m_usernameHasBeenSet; }
inline void SetUsername(const Aws::String& value) { m_usernameHasBeenSet = true; m_username = value; }
inline void SetUsername(Aws::String&& value) { m_usernameHasBeenSet = true; m_username = std::move(value); }
inline void SetUsername(const char* value) { m_usernameHasBeenSet = true; m_username.assign(value); }
inline AdminUpdateUserAttributesRequest& WithUsername(const Aws::String& value) { SetUsername(value); return *this;}
inline AdminUpdateUserAttributesRequest& WithUsername(Aws::String&& value) { SetUsername(std::move(value)); return *this;}
inline AdminUpdateUserAttributesRequest& WithUsername(const char* value) { SetUsername(value); return *this;}
///@}
///@{
/**
* An array of name-value pairs representing user attributes.
For custom
* attributes, you must prepend the custom: prefix to the attribute
* name.
If your user pool requires verification before Amazon Cognito
* updates an attribute value that you specify in this request, Amazon Cognito
* doesn’t immediately update the value of that attribute. After your user receives
* and responds to a verification message to verify the new value, Amazon Cognito
* updates the attribute value. Your user can sign in and receive messages with the
* original attribute value until they verify the new value.
To update the
* value of an attribute that requires verification in the same API request,
* include the email_verified or phone_number_verified
* attribute, with a value of true. If you set the
* email_verified or phone_number_verified value for an
* email or phone_number attribute that requires
* verification to true, Amazon Cognito doesn’t send a verification
* message to your user.
*/
inline const Aws::Vector& GetUserAttributes() const{ return m_userAttributes; }
inline bool UserAttributesHasBeenSet() const { return m_userAttributesHasBeenSet; }
inline void SetUserAttributes(const Aws::Vector& value) { m_userAttributesHasBeenSet = true; m_userAttributes = value; }
inline void SetUserAttributes(Aws::Vector&& value) { m_userAttributesHasBeenSet = true; m_userAttributes = std::move(value); }
inline AdminUpdateUserAttributesRequest& WithUserAttributes(const Aws::Vector& value) { SetUserAttributes(value); return *this;}
inline AdminUpdateUserAttributesRequest& WithUserAttributes(Aws::Vector&& value) { SetUserAttributes(std::move(value)); return *this;}
inline AdminUpdateUserAttributesRequest& AddUserAttributes(const AttributeType& value) { m_userAttributesHasBeenSet = true; m_userAttributes.push_back(value); return *this; }
inline AdminUpdateUserAttributesRequest& AddUserAttributes(AttributeType&& value) { m_userAttributesHasBeenSet = true; m_userAttributes.push_back(std::move(value)); return *this; }
///@}
///@{
/**
* A map of custom key-value pairs that you can provide as input for any custom
* workflows that this action triggers.
You create custom workflows by
* assigning Lambda functions to user pool triggers. When you use the
* AdminUpdateUserAttributes API action, Amazon Cognito invokes the function that
* is assigned to the custom message trigger. When Amazon Cognito invokes
* this function, it passes a JSON payload, which the function receives as input.
* This payload contains a clientMetadata attribute, which provides
* the data that you assigned to the ClientMetadata parameter in your
* AdminUpdateUserAttributes request. In your function code in Lambda, you can
* process the clientMetadata value to enhance your workflow for your
* specific needs.
For more information, see
* Customizing user pool Workflows with Lambda Triggers in the Amazon
* Cognito Developer Guide.
When you use the ClientMetadata
* parameter, remember that Amazon Cognito won't do the following:
-
*
Store the ClientMetadata value. This data is available only to Lambda
* triggers that are assigned to a user pool to support custom workflows. If your
* user pool configuration doesn't include triggers, the ClientMetadata parameter
* serves no purpose.
-
Validate the ClientMetadata value.
* -
Encrypt the ClientMetadata value. Don't use Amazon Cognito to
* provide sensitive information.
*/
inline const Aws::Map& GetClientMetadata() const{ return m_clientMetadata; }
inline bool ClientMetadataHasBeenSet() const { return m_clientMetadataHasBeenSet; }
inline void SetClientMetadata(const Aws::Map& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata = value; }
inline void SetClientMetadata(Aws::Map&& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata = std::move(value); }
inline AdminUpdateUserAttributesRequest& WithClientMetadata(const Aws::Map& value) { SetClientMetadata(value); return *this;}
inline AdminUpdateUserAttributesRequest& WithClientMetadata(Aws::Map&& value) { SetClientMetadata(std::move(value)); return *this;}
inline AdminUpdateUserAttributesRequest& AddClientMetadata(const Aws::String& key, const Aws::String& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(key, value); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(Aws::String&& key, const Aws::String& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(std::move(key), value); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(const Aws::String& key, Aws::String&& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(key, std::move(value)); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(Aws::String&& key, Aws::String&& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(std::move(key), std::move(value)); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(const char* key, Aws::String&& value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(key, std::move(value)); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(Aws::String&& key, const char* value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(std::move(key), value); return *this; }
inline AdminUpdateUserAttributesRequest& AddClientMetadata(const char* key, const char* value) { m_clientMetadataHasBeenSet = true; m_clientMetadata.emplace(key, value); return *this; }
///@}
private:
Aws::String m_userPoolId;
bool m_userPoolIdHasBeenSet = false;
Aws::String m_username;
bool m_usernameHasBeenSet = false;
Aws::Vector m_userAttributes;
bool m_userAttributesHasBeenSet = false;
Aws::Map m_clientMetadata;
bool m_clientMetadataHasBeenSet = false;
};
} // namespace Model
} // namespace CognitoIdentityProvider
} // namespace Aws