/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include namespace Aws { namespace IAM { namespace Model { /** */ class ListGroupsRequest : public IAMRequest { public: AWS_IAM_API ListGroupsRequest(); // 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 "ListGroups"; } AWS_IAM_API Aws::String SerializePayload() const override; protected: AWS_IAM_API void DumpBodyToUrl(Aws::Http::URI& uri ) const override; public: /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline const Aws::String& GetPathPrefix() const{ return m_pathPrefix; } /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline bool PathPrefixHasBeenSet() const { return m_pathPrefixHasBeenSet; } /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline void SetPathPrefix(const Aws::String& value) { m_pathPrefixHasBeenSet = true; m_pathPrefix = value; } /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline void SetPathPrefix(Aws::String&& value) { m_pathPrefixHasBeenSet = true; m_pathPrefix = std::move(value); } /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline void SetPathPrefix(const char* value) { m_pathPrefixHasBeenSet = true; m_pathPrefix.assign(value); } /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline ListGroupsRequest& WithPathPrefix(const Aws::String& value) { SetPathPrefix(value); return *this;} /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline ListGroupsRequest& WithPathPrefix(Aws::String&& value) { SetPathPrefix(std::move(value)); return *this;} /** *

The path prefix for filtering the results. For example, the prefix * /division_abc/subdivision_xyz/ gets all groups whose path starts * with /division_abc/subdivision_xyz/.

This parameter is * optional. If it is not included, it defaults to a slash (/), listing all groups. * This parameter allows (through its regex pattern) a string of characters * consisting of either a forward slash (/) by itself or a string that must begin * and end with forward slashes. In addition, it can contain any ASCII character * from the ! (\u0021) through the DEL character * (\u007F), including most punctuation characters, digits, and upper * and lowercased letters.

*/ inline ListGroupsRequest& WithPathPrefix(const char* value) { SetPathPrefix(value); return *this;} /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline const Aws::String& GetMarker() const{ return m_marker; } /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline bool MarkerHasBeenSet() const { return m_markerHasBeenSet; } /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline void SetMarker(const Aws::String& value) { m_markerHasBeenSet = true; m_marker = value; } /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline void SetMarker(Aws::String&& value) { m_markerHasBeenSet = true; m_marker = std::move(value); } /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline void SetMarker(const char* value) { m_markerHasBeenSet = true; m_marker.assign(value); } /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline ListGroupsRequest& WithMarker(const Aws::String& value) { SetMarker(value); return *this;} /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline ListGroupsRequest& WithMarker(Aws::String&& value) { SetMarker(std::move(value)); return *this;} /** *

Use this parameter only when paginating results and only after you receive a * response indicating that the results are truncated. Set it to the value of the * Marker element in the response that you received to indicate where * the next call should start.

*/ inline ListGroupsRequest& WithMarker(const char* value) { SetMarker(value); return *this;} /** *

Use this only when paginating results to indicate the maximum number of items * you want in the response. If additional items exist beyond the maximum you * specify, the IsTruncated response element is true.

*

If you do not include this parameter, the number of items defaults to 100. * Note that IAM might return fewer results, even when there are more results * available. In that case, the IsTruncated response element returns * true, and Marker contains a value to include in the * subsequent call that tells the service where to continue from.

*/ inline int GetMaxItems() const{ return m_maxItems; } /** *

Use this only when paginating results to indicate the maximum number of items * you want in the response. If additional items exist beyond the maximum you * specify, the IsTruncated response element is true.

*

If you do not include this parameter, the number of items defaults to 100. * Note that IAM might return fewer results, even when there are more results * available. In that case, the IsTruncated response element returns * true, and Marker contains a value to include in the * subsequent call that tells the service where to continue from.

*/ inline bool MaxItemsHasBeenSet() const { return m_maxItemsHasBeenSet; } /** *

Use this only when paginating results to indicate the maximum number of items * you want in the response. If additional items exist beyond the maximum you * specify, the IsTruncated response element is true.

*

If you do not include this parameter, the number of items defaults to 100. * Note that IAM might return fewer results, even when there are more results * available. In that case, the IsTruncated response element returns * true, and Marker contains a value to include in the * subsequent call that tells the service where to continue from.

*/ inline void SetMaxItems(int value) { m_maxItemsHasBeenSet = true; m_maxItems = value; } /** *

Use this only when paginating results to indicate the maximum number of items * you want in the response. If additional items exist beyond the maximum you * specify, the IsTruncated response element is true.

*

If you do not include this parameter, the number of items defaults to 100. * Note that IAM might return fewer results, even when there are more results * available. In that case, the IsTruncated response element returns * true, and Marker contains a value to include in the * subsequent call that tells the service where to continue from.

*/ inline ListGroupsRequest& WithMaxItems(int value) { SetMaxItems(value); return *this;} private: Aws::String m_pathPrefix; bool m_pathPrefixHasBeenSet = false; Aws::String m_marker; bool m_markerHasBeenSet = false; int m_maxItems; bool m_maxItemsHasBeenSet = false; }; } // namespace Model } // namespace IAM } // namespace Aws