/** * 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 Http { class URI; } //namespace Http namespace WorkDocs { namespace Model { /** */ class DescribeUsersRequest : public WorkDocsRequest { public: AWS_WORKDOCS_API DescribeUsersRequest(); // 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 "DescribeUsers"; } AWS_WORKDOCS_API Aws::String SerializePayload() const override; AWS_WORKDOCS_API void AddQueryStringParameters(Aws::Http::URI& uri) const override; AWS_WORKDOCS_API Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override; /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline const Aws::String& GetAuthenticationToken() const{ return m_authenticationToken; } /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline bool AuthenticationTokenHasBeenSet() const { return m_authenticationTokenHasBeenSet; } /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline void SetAuthenticationToken(const Aws::String& value) { m_authenticationTokenHasBeenSet = true; m_authenticationToken = value; } /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline void SetAuthenticationToken(Aws::String&& value) { m_authenticationTokenHasBeenSet = true; m_authenticationToken = std::move(value); } /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline void SetAuthenticationToken(const char* value) { m_authenticationTokenHasBeenSet = true; m_authenticationToken.assign(value); } /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline DescribeUsersRequest& WithAuthenticationToken(const Aws::String& value) { SetAuthenticationToken(value); return *this;} /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline DescribeUsersRequest& WithAuthenticationToken(Aws::String&& value) { SetAuthenticationToken(std::move(value)); return *this;} /** *

Amazon WorkDocs authentication token. Not required when using Amazon Web * Services administrator credentials to access the API.

*/ inline DescribeUsersRequest& WithAuthenticationToken(const char* value) { SetAuthenticationToken(value); return *this;} /** *

The ID of the organization.

*/ inline const Aws::String& GetOrganizationId() const{ return m_organizationId; } /** *

The ID of the organization.

*/ inline bool OrganizationIdHasBeenSet() const { return m_organizationIdHasBeenSet; } /** *

The ID of the organization.

*/ inline void SetOrganizationId(const Aws::String& value) { m_organizationIdHasBeenSet = true; m_organizationId = value; } /** *

The ID of the organization.

*/ inline void SetOrganizationId(Aws::String&& value) { m_organizationIdHasBeenSet = true; m_organizationId = std::move(value); } /** *

The ID of the organization.

*/ inline void SetOrganizationId(const char* value) { m_organizationIdHasBeenSet = true; m_organizationId.assign(value); } /** *

The ID of the organization.

*/ inline DescribeUsersRequest& WithOrganizationId(const Aws::String& value) { SetOrganizationId(value); return *this;} /** *

The ID of the organization.

*/ inline DescribeUsersRequest& WithOrganizationId(Aws::String&& value) { SetOrganizationId(std::move(value)); return *this;} /** *

The ID of the organization.

*/ inline DescribeUsersRequest& WithOrganizationId(const char* value) { SetOrganizationId(value); return *this;} /** *

The IDs of the users.

*/ inline const Aws::String& GetUserIds() const{ return m_userIds; } /** *

The IDs of the users.

*/ inline bool UserIdsHasBeenSet() const { return m_userIdsHasBeenSet; } /** *

The IDs of the users.

*/ inline void SetUserIds(const Aws::String& value) { m_userIdsHasBeenSet = true; m_userIds = value; } /** *

The IDs of the users.

*/ inline void SetUserIds(Aws::String&& value) { m_userIdsHasBeenSet = true; m_userIds = std::move(value); } /** *

The IDs of the users.

*/ inline void SetUserIds(const char* value) { m_userIdsHasBeenSet = true; m_userIds.assign(value); } /** *

The IDs of the users.

*/ inline DescribeUsersRequest& WithUserIds(const Aws::String& value) { SetUserIds(value); return *this;} /** *

The IDs of the users.

*/ inline DescribeUsersRequest& WithUserIds(Aws::String&& value) { SetUserIds(std::move(value)); return *this;} /** *

The IDs of the users.

*/ inline DescribeUsersRequest& WithUserIds(const char* value) { SetUserIds(value); return *this;} /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline const Aws::String& GetQuery() const{ return m_query; } /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline bool QueryHasBeenSet() const { return m_queryHasBeenSet; } /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline void SetQuery(const Aws::String& value) { m_queryHasBeenSet = true; m_query = value; } /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline void SetQuery(Aws::String&& value) { m_queryHasBeenSet = true; m_query = std::move(value); } /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline void SetQuery(const char* value) { m_queryHasBeenSet = true; m_query.assign(value); } /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline DescribeUsersRequest& WithQuery(const Aws::String& value) { SetQuery(value); return *this;} /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline DescribeUsersRequest& WithQuery(Aws::String&& value) { SetQuery(std::move(value)); return *this;} /** *

A query to filter users by user name. Remember the following about the * Userids and Query parameters:

  • If you * don't use either parameter, the API returns a paginated list of all users on the * site.

  • If you use both parameters, the API ignores the * Query parameter.

  • The Userid * parameter only returns user names that match a corresponding user ID.

  • *
  • The Query parameter runs a "prefix" search for users by the * GivenName, SurName, or UserName fields * included in a CreateUser * API call. For example, querying on Ma returns Márcia Oliveira, * María García, and Mateo Jackson. If you use multiple characters, the API only * returns data that matches all characters. For example, querying on Ma * J only returns Mateo Jackson.

*/ inline DescribeUsersRequest& WithQuery(const char* value) { SetQuery(value); return *this;} /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline const UserFilterType& GetInclude() const{ return m_include; } /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline bool IncludeHasBeenSet() const { return m_includeHasBeenSet; } /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline void SetInclude(const UserFilterType& value) { m_includeHasBeenSet = true; m_include = value; } /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline void SetInclude(UserFilterType&& value) { m_includeHasBeenSet = true; m_include = std::move(value); } /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline DescribeUsersRequest& WithInclude(const UserFilterType& value) { SetInclude(value); return *this;} /** *

The state of the users. Specify "ALL" to include inactive users.

*/ inline DescribeUsersRequest& WithInclude(UserFilterType&& value) { SetInclude(std::move(value)); return *this;} /** *

The order for the results.

*/ inline const OrderType& GetOrder() const{ return m_order; } /** *

The order for the results.

*/ inline bool OrderHasBeenSet() const { return m_orderHasBeenSet; } /** *

The order for the results.

*/ inline void SetOrder(const OrderType& value) { m_orderHasBeenSet = true; m_order = value; } /** *

The order for the results.

*/ inline void SetOrder(OrderType&& value) { m_orderHasBeenSet = true; m_order = std::move(value); } /** *

The order for the results.

*/ inline DescribeUsersRequest& WithOrder(const OrderType& value) { SetOrder(value); return *this;} /** *

The order for the results.

*/ inline DescribeUsersRequest& WithOrder(OrderType&& value) { SetOrder(std::move(value)); return *this;} /** *

The sorting criteria.

*/ inline const UserSortType& GetSort() const{ return m_sort; } /** *

The sorting criteria.

*/ inline bool SortHasBeenSet() const { return m_sortHasBeenSet; } /** *

The sorting criteria.

*/ inline void SetSort(const UserSortType& value) { m_sortHasBeenSet = true; m_sort = value; } /** *

The sorting criteria.

*/ inline void SetSort(UserSortType&& value) { m_sortHasBeenSet = true; m_sort = std::move(value); } /** *

The sorting criteria.

*/ inline DescribeUsersRequest& WithSort(const UserSortType& value) { SetSort(value); return *this;} /** *

The sorting criteria.

*/ inline DescribeUsersRequest& WithSort(UserSortType&& value) { SetSort(std::move(value)); return *this;} /** *

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The marker for the next set of results. (You received this marker from a * previous call.)

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

The maximum number of items to return.

*/ inline int GetLimit() const{ return m_limit; } /** *

The maximum number of items to return.

*/ inline bool LimitHasBeenSet() const { return m_limitHasBeenSet; } /** *

The maximum number of items to return.

*/ inline void SetLimit(int value) { m_limitHasBeenSet = true; m_limit = value; } /** *

The maximum number of items to return.

*/ inline DescribeUsersRequest& WithLimit(int value) { SetLimit(value); return *this;} /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline const Aws::String& GetFields() const{ return m_fields; } /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline bool FieldsHasBeenSet() const { return m_fieldsHasBeenSet; } /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline void SetFields(const Aws::String& value) { m_fieldsHasBeenSet = true; m_fields = value; } /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline void SetFields(Aws::String&& value) { m_fieldsHasBeenSet = true; m_fields = std::move(value); } /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline void SetFields(const char* value) { m_fieldsHasBeenSet = true; m_fields.assign(value); } /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline DescribeUsersRequest& WithFields(const Aws::String& value) { SetFields(value); return *this;} /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline DescribeUsersRequest& WithFields(Aws::String&& value) { SetFields(std::move(value)); return *this;} /** *

A comma-separated list of values. Specify "STORAGE_METADATA" to include the * user storage quota and utilization information.

*/ inline DescribeUsersRequest& WithFields(const char* value) { SetFields(value); return *this;} private: Aws::String m_authenticationToken; bool m_authenticationTokenHasBeenSet = false; Aws::String m_organizationId; bool m_organizationIdHasBeenSet = false; Aws::String m_userIds; bool m_userIdsHasBeenSet = false; Aws::String m_query; bool m_queryHasBeenSet = false; UserFilterType m_include; bool m_includeHasBeenSet = false; OrderType m_order; bool m_orderHasBeenSet = false; UserSortType m_sort; bool m_sortHasBeenSet = false; Aws::String m_marker; bool m_markerHasBeenSet = false; int m_limit; bool m_limitHasBeenSet = false; Aws::String m_fields; bool m_fieldsHasBeenSet = false; }; } // namespace Model } // namespace WorkDocs } // namespace Aws