pub struct Client { /* private fields */ }
Expand description

Client for Amazon QuickSight

Client for invoking operations on Amazon QuickSight. Each operation on Amazon QuickSight is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_quicksight::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::RetryConfig;
let shared_config = aws_config::load_from_env().await;
let config = aws_sdk_quicksight::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_quicksight::Client::from_conf(config);

Implementations

Creates a client with the given service configuration.

Returns the client’s configuration.

Constructs a fluent builder for the CancelIngestion operation.

Constructs a fluent builder for the CreateAccountCustomization operation.

Constructs a fluent builder for the CreateAnalysis operation.

Constructs a fluent builder for the CreateDashboard operation.

Constructs a fluent builder for the CreateDataSet operation.

Constructs a fluent builder for the CreateDataSource operation.

Constructs a fluent builder for the CreateFolder operation.

Constructs a fluent builder for the CreateFolderMembership operation.

Constructs a fluent builder for the CreateGroup operation.

Constructs a fluent builder for the CreateGroupMembership operation.

Constructs a fluent builder for the CreateIAMPolicyAssignment operation.

Constructs a fluent builder for the CreateIngestion operation.

Constructs a fluent builder for the CreateNamespace operation.

Constructs a fluent builder for the CreateTemplate operation.

Constructs a fluent builder for the CreateTemplateAlias operation.

Constructs a fluent builder for the CreateTheme operation.

Constructs a fluent builder for the CreateThemeAlias operation.

Constructs a fluent builder for the DeleteAccountCustomization operation.

Constructs a fluent builder for the DeleteAnalysis operation.

Constructs a fluent builder for the DeleteDashboard operation.

Constructs a fluent builder for the DeleteDataSet operation.

Constructs a fluent builder for the DeleteDataSource operation.

Constructs a fluent builder for the DeleteFolder operation.

Constructs a fluent builder for the DeleteFolderMembership operation.

Constructs a fluent builder for the DeleteGroup operation.

Constructs a fluent builder for the DeleteGroupMembership operation.

Constructs a fluent builder for the DeleteIAMPolicyAssignment operation.

Constructs a fluent builder for the DeleteNamespace operation.

Constructs a fluent builder for the DeleteTemplate operation.

Constructs a fluent builder for the DeleteTemplateAlias operation.

Constructs a fluent builder for the DeleteTheme operation.

Constructs a fluent builder for the DeleteThemeAlias operation.

Constructs a fluent builder for the DeleteUser operation.

Constructs a fluent builder for the DeleteUserByPrincipalId operation.

Constructs a fluent builder for the DescribeAccountCustomization operation.

Constructs a fluent builder for the DescribeAccountSettings operation.

  • The fluent builder is configurable:
  • On success, responds with DescribeAccountSettingsOutput with field(s):
    • account_settings(Option<AccountSettings>):

      The Amazon QuickSight settings for this Amazon Web Services account. This information includes the edition of Amazon Amazon QuickSight that you subscribed to (Standard or Enterprise) and the notification email for the Amazon QuickSight subscription. In the QuickSight console, the Amazon QuickSight subscription is sometimes referred to as a QuickSight “account” even though it’s technically not an account by itself. Instead, it’s a subscription to the Amazon QuickSight service for your Amazon Web Services account. The edition that you subscribe to applies to Amazon QuickSight in every Amazon Web Services Region where you use it.

    • request_id(Option<String>):

      The Amazon Web Services request ID for this operation.

    • status(i32):

      The HTTP status of the request.

  • On failure, responds with SdkError<DescribeAccountSettingsError>

Constructs a fluent builder for the DescribeAnalysis operation.

Constructs a fluent builder for the DescribeAnalysisPermissions operation.

Constructs a fluent builder for the DescribeDashboard operation.

Constructs a fluent builder for the DescribeDashboardPermissions operation.

Constructs a fluent builder for the DescribeDataSet operation.

Constructs a fluent builder for the DescribeDataSetPermissions operation.

Constructs a fluent builder for the DescribeDataSource operation.

Constructs a fluent builder for the DescribeDataSourcePermissions operation.

Constructs a fluent builder for the DescribeFolder operation.

Constructs a fluent builder for the DescribeFolderPermissions operation.

Constructs a fluent builder for the DescribeFolderResolvedPermissions operation.

Constructs a fluent builder for the DescribeGroup operation.

Constructs a fluent builder for the DescribeGroupMembership operation.

Constructs a fluent builder for the DescribeIAMPolicyAssignment operation.

Constructs a fluent builder for the DescribeIngestion operation.

Constructs a fluent builder for the DescribeIpRestriction operation.

Constructs a fluent builder for the DescribeNamespace operation.

Constructs a fluent builder for the DescribeTemplate operation.

Constructs a fluent builder for the DescribeTemplateAlias operation.

Constructs a fluent builder for the DescribeTemplatePermissions operation.

Constructs a fluent builder for the DescribeTheme operation.

Constructs a fluent builder for the DescribeThemeAlias operation.

Constructs a fluent builder for the DescribeThemePermissions operation.

Constructs a fluent builder for the DescribeUser operation.

Constructs a fluent builder for the GenerateEmbedUrlForAnonymousUser operation.

Constructs a fluent builder for the GenerateEmbedUrlForRegisteredUser operation.

Constructs a fluent builder for the GetDashboardEmbedUrl operation.

Constructs a fluent builder for the GetSessionEmbedUrl operation.

  • The fluent builder is configurable:
    • aws_account_id(impl Into<String>) / set_aws_account_id(Option<String>):

      The ID for the Amazon Web Services account associated with your Amazon QuickSight subscription.

    • entry_point(impl Into<String>) / set_entry_point(Option<String>):

      The URL you use to access the embedded session. The entry point URL is constrained to the following paths:

      • /start

      • /start/analyses

      • /start/dashboards

      • /start/favorites

      • /dashboards/DashboardId - where DashboardId is the actual ID key from the Amazon QuickSight console URL of the dashboard

      • /analyses/AnalysisId - where AnalysisId is the actual ID key from the Amazon QuickSight console URL of the analysis

    • session_lifetime_in_minutes(i64) / set_session_lifetime_in_minutes(Option<i64>):

      How many minutes the session is valid. The session lifetime must be 15-600 minutes.

    • user_arn(impl Into<String>) / set_user_arn(Option<String>):

      The Amazon QuickSight user’s Amazon Resource Name (ARN), for use with QUICKSIGHT identity type. You can use this for any type of Amazon QuickSight users in your account (readers, authors, or admins). They need to be authenticated as one of the following:

      1. Active Directory (AD) users or group members

      2. Invited nonfederated users

      3. Identity and Access Management (IAM) users and IAM role-based sessions authenticated through Federated Single Sign-On using SAML, OpenID Connect, or IAM federation

      Omit this parameter for users in the third group, IAM users and IAM role-based sessions.

  • On success, responds with GetSessionEmbedUrlOutput with field(s):
    • embed_url(Option<String>):

      A single-use URL that you can put into your server-side web page to embed your Amazon QuickSight session. This URL is valid for 5 minutes. The API operation provides the URL with an auth_code value that enables one (and only one) sign-on to a user session that is valid for 10 hours.

    • status(i32):

      The HTTP status of the request.

    • request_id(Option<String>):

      The Amazon Web Services request ID for this operation.

  • On failure, responds with SdkError<GetSessionEmbedUrlError>

Constructs a fluent builder for the ListAnalyses operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDashboards operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDashboardVersions operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDataSets operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDataSources operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListFolderMembers operation.

Constructs a fluent builder for the ListFolders operation.

Constructs a fluent builder for the ListGroupMemberships operation.

Constructs a fluent builder for the ListGroups operation.

Constructs a fluent builder for the ListIAMPolicyAssignments operation.

Constructs a fluent builder for the ListIAMPolicyAssignmentsForUser operation.

Constructs a fluent builder for the ListIngestions operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListNamespaces operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListTagsForResource operation.

Constructs a fluent builder for the ListTemplateAliases operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListTemplates operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListTemplateVersions operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListThemeAliases operation.

Constructs a fluent builder for the ListThemes operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListThemeVersions operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListUserGroups operation.

Constructs a fluent builder for the ListUsers operation.

Constructs a fluent builder for the RegisterUser operation.

  • The fluent builder is configurable:
    • identity_type(IdentityType) / set_identity_type(Option<IdentityType>):

      Amazon QuickSight supports several ways of managing the identity of users. This parameter accepts two values:

      • IAM: A user whose identity maps to an existing IAM user or role.

      • QUICKSIGHT: A user whose identity is owned and managed internally by Amazon QuickSight.

    • email(impl Into<String>) / set_email(Option<String>):

      The email address of the user that you want to register.

    • user_role(UserRole) / set_user_role(Option<UserRole>):

      The Amazon QuickSight role for the user. The user role can be one of the following:

      • READER: A user who has read-only access to dashboards.

      • AUTHOR: A user who can create data sources, datasets, analyses, and dashboards.

      • ADMIN: A user who is an author, who can also manage Amazon QuickSight settings.

      • RESTRICTED_READER: This role isn’t currently available for use.

      • RESTRICTED_AUTHOR: This role isn’t currently available for use.

    • iam_arn(impl Into<String>) / set_iam_arn(Option<String>):

      The ARN of the IAM user or role that you are registering with Amazon QuickSight.

    • session_name(impl Into<String>) / set_session_name(Option<String>):

      You need to use this parameter only when you register one or more users using an assumed IAM role. You don’t need to provide the session name for other scenarios, for example when you are registering an IAM user or an Amazon QuickSight user. You can register multiple users using the same IAM role if each user has a different session name. For more information on assuming IAM roles, see assume-role in the CLI Reference.

    • aws_account_id(impl Into<String>) / set_aws_account_id(Option<String>):

      The ID for the Amazon Web Services account that the user is in. Currently, you use the ID for the Amazon Web Services account that contains your Amazon QuickSight account.

    • namespace(impl Into<String>) / set_namespace(Option<String>):

      The namespace. Currently, you should set this to default.

    • user_name(impl Into<String>) / set_user_name(Option<String>):

      The Amazon QuickSight user name that you want to create for the user you are registering.

    • custom_permissions_name(impl Into<String>) / set_custom_permissions_name(Option<String>):

      (Enterprise edition only) The name of the custom permissions profile that you want to assign to this user. Customized permissions allows you to control a user’s access by restricting access the following operations:

      • Create and update data sources

      • Create and update datasets

      • Create and update email reports

      • Subscribe to email reports

      To add custom permissions to an existing user, use UpdateUser instead.

      A set of custom permissions includes any combination of these restrictions. Currently, you need to create the profile names for custom permission sets by using the Amazon QuickSight console. Then, you use the RegisterUser API operation to assign the named set of permissions to a Amazon QuickSight user.

      Amazon QuickSight custom permissions are applied through IAM policies. Therefore, they override the permissions typically granted by assigning Amazon QuickSight users to one of the default security cohorts in Amazon QuickSight (admin, author, reader).

      This feature is available only to Amazon QuickSight Enterprise edition subscriptions.

    • external_login_federation_provider_type(impl Into<String>) / set_external_login_federation_provider_type(Option<String>):

      The type of supported external login provider that provides identity to let a user federate into Amazon QuickSight with an associated Identity and Access Management(IAM) role. The type of supported external login provider can be one of the following.

      • COGNITO: Amazon Cognito. The provider URL is cognito-identity.amazonaws.com. When choosing the COGNITO provider type, don’t use the “CustomFederationProviderUrl” parameter which is only needed when the external provider is custom.

      • CUSTOM_OIDC: Custom OpenID Connect (OIDC) provider. When choosing CUSTOM_OIDC type, use the CustomFederationProviderUrl parameter to provide the custom OIDC provider URL.

    • custom_federation_provider_url(impl Into<String>) / set_custom_federation_provider_url(Option<String>):

      The URL of the custom OpenID Connect (OIDC) provider that provides identity to let a user federate into Amazon QuickSight with an associated Identity and Access Management(IAM) role. This parameter should only be used when ExternalLoginFederationProviderType parameter is set to CUSTOM_OIDC.

    • external_login_id(impl Into<String>) / set_external_login_id(Option<String>):

      The identity ID for a user in the external login provider.

  • On success, responds with RegisterUserOutput with field(s):
  • On failure, responds with SdkError<RegisterUserError>

Constructs a fluent builder for the RestoreAnalysis operation.

Constructs a fluent builder for the SearchAnalyses operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the SearchDashboards operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the SearchFolders operation.

Constructs a fluent builder for the SearchGroups operation.

Constructs a fluent builder for the TagResource operation.

Constructs a fluent builder for the UntagResource operation.

Constructs a fluent builder for the UpdateAccountCustomization operation.

Constructs a fluent builder for the UpdateAccountSettings operation.

Constructs a fluent builder for the UpdateAnalysis operation.

Constructs a fluent builder for the UpdateAnalysisPermissions operation.

Constructs a fluent builder for the UpdateDashboard operation.

Constructs a fluent builder for the UpdateDashboardPermissions operation.

Constructs a fluent builder for the UpdateDashboardPublishedVersion operation.

Constructs a fluent builder for the UpdateDataSet operation.

Constructs a fluent builder for the UpdateDataSetPermissions operation.

Constructs a fluent builder for the UpdateDataSource operation.

Constructs a fluent builder for the UpdateDataSourcePermissions operation.

Constructs a fluent builder for the UpdateFolder operation.

Constructs a fluent builder for the UpdateFolderPermissions operation.

Constructs a fluent builder for the UpdateGroup operation.

Constructs a fluent builder for the UpdateIAMPolicyAssignment operation.

Constructs a fluent builder for the UpdateIpRestriction operation.

Constructs a fluent builder for the UpdateTemplate operation.

Constructs a fluent builder for the UpdateTemplateAlias operation.

Constructs a fluent builder for the UpdateTemplatePermissions operation.

Constructs a fluent builder for the UpdateTheme operation.

Constructs a fluent builder for the UpdateThemeAlias operation.

Constructs a fluent builder for the UpdateThemePermissions operation.

Constructs a fluent builder for the UpdateUser operation.

  • The fluent builder is configurable:
    • user_name(impl Into<String>) / set_user_name(Option<String>):

      The Amazon QuickSight user name that you want to update.

    • aws_account_id(impl Into<String>) / set_aws_account_id(Option<String>):

      The ID for the Amazon Web Services account that the user is in. Currently, you use the ID for the Amazon Web Services account that contains your Amazon QuickSight account.

    • namespace(impl Into<String>) / set_namespace(Option<String>):

      The namespace. Currently, you should set this to default.

    • email(impl Into<String>) / set_email(Option<String>):

      The email address of the user that you want to update.

    • role(UserRole) / set_role(Option<UserRole>):

      The Amazon QuickSight role of the user. The role can be one of the following default security cohorts:

      • READER: A user who has read-only access to dashboards.

      • AUTHOR: A user who can create data sources, datasets, analyses, and dashboards.

      • ADMIN: A user who is an author, who can also manage Amazon QuickSight settings.

      The name of the Amazon QuickSight role is invisible to the user except for the console screens dealing with permissions.

    • custom_permissions_name(impl Into<String>) / set_custom_permissions_name(Option<String>):

      (Enterprise edition only) The name of the custom permissions profile that you want to assign to this user. Customized permissions allows you to control a user’s access by restricting access the following operations:

      • Create and update data sources

      • Create and update datasets

      • Create and update email reports

      • Subscribe to email reports

      A set of custom permissions includes any combination of these restrictions. Currently, you need to create the profile names for custom permission sets by using the Amazon QuickSight console. Then, you use the RegisterUser API operation to assign the named set of permissions to a Amazon QuickSight user.

      Amazon QuickSight custom permissions are applied through IAM policies. Therefore, they override the permissions typically granted by assigning Amazon QuickSight users to one of the default security cohorts in Amazon QuickSight (admin, author, reader).

      This feature is available only to Amazon QuickSight Enterprise edition subscriptions.

    • unapply_custom_permissions(bool) / set_unapply_custom_permissions(bool):

      A flag that you use to indicate that you want to remove all custom permissions from this user. Using this parameter resets the user to the state it was in before a custom permissions profile was applied. This parameter defaults to NULL and it doesn’t accept any other value.

    • external_login_federation_provider_type(impl Into<String>) / set_external_login_federation_provider_type(Option<String>):

      The type of supported external login provider that provides identity to let a user federate into Amazon QuickSight with an associated Identity and Access Management(IAM) role. The type of supported external login provider can be one of the following.

      • COGNITO: Amazon Cognito. The provider URL is cognito-identity.amazonaws.com. When choosing the COGNITO provider type, don’t use the “CustomFederationProviderUrl” parameter which is only needed when the external provider is custom.

      • CUSTOM_OIDC: Custom OpenID Connect (OIDC) provider. When choosing CUSTOM_OIDC type, use the CustomFederationProviderUrl parameter to provide the custom OIDC provider URL.

      • NONE: This clears all the previously saved external login information for a user. Use the DescribeUser API operation to check the external login information.

    • custom_federation_provider_url(impl Into<String>) / set_custom_federation_provider_url(Option<String>):

      The URL of the custom OpenID Connect (OIDC) provider that provides identity to let a user federate into Amazon QuickSight with an associated Identity and Access Management(IAM) role. This parameter should only be used when ExternalLoginFederationProviderType parameter is set to CUSTOM_OIDC.

    • external_login_id(impl Into<String>) / set_external_login_id(Option<String>):

      The identity ID for a user in the external login provider.

  • On success, responds with UpdateUserOutput with field(s):
  • On failure, responds with SdkError<UpdateUserError>

Creates a client with the given service config and connector override.

Creates a new client from a shared config.

Creates a new client from the service Config.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Converts to this type from the input type.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more