Class CfnDataSource

java.lang.Object
software.amazon.jsii.JsiiObject
All Implemented Interfaces:
IConstruct, IDependable, IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:30:23.384Z") @Stability(Stable) public class CfnDataSource extends CfnResource implements IInspectable
A CloudFormation AWS::QuickSight::DataSource.

Creates a data source.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.quicksight.*;
 CfnDataSource cfnDataSource = CfnDataSource.Builder.create(this, "MyCfnDataSource")
         .alternateDataSourceParameters(List.of(DataSourceParametersProperty.builder()
                 .amazonElasticsearchParameters(AmazonElasticsearchParametersProperty.builder()
                         .domain("domain")
                         .build())
                 .amazonOpenSearchParameters(AmazonOpenSearchParametersProperty.builder()
                         .domain("domain")
                         .build())
                 .athenaParameters(AthenaParametersProperty.builder()
                         .roleArn("roleArn")
                         .workGroup("workGroup")
                         .build())
                 .auroraParameters(AuroraParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .auroraPostgreSqlParameters(AuroraPostgreSqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .databricksParameters(DatabricksParametersProperty.builder()
                         .host("host")
                         .port(123)
                         .sqlEndpointPath("sqlEndpointPath")
                         .build())
                 .mariaDbParameters(MariaDbParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .mySqlParameters(MySqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .oracleParameters(OracleParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .postgreSqlParameters(PostgreSqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .prestoParameters(PrestoParametersProperty.builder()
                         .catalog("catalog")
                         .host("host")
                         .port(123)
                         .build())
                 .rdsParameters(RdsParametersProperty.builder()
                         .database("database")
                         .instanceId("instanceId")
                         .build())
                 .redshiftParameters(RedshiftParametersProperty.builder()
                         .database("database")
                         // the properties below are optional
                         .clusterId("clusterId")
                         .host("host")
                         .port(123)
                         .build())
                 .s3Parameters(S3ParametersProperty.builder()
                         .manifestFileLocation(ManifestFileLocationProperty.builder()
                                 .bucket("bucket")
                                 .key("key")
                                 .build())
                         // the properties below are optional
                         .roleArn("roleArn")
                         .build())
                 .snowflakeParameters(SnowflakeParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .warehouse("warehouse")
                         .build())
                 .sparkParameters(SparkParametersProperty.builder()
                         .host("host")
                         .port(123)
                         .build())
                 .sqlServerParameters(SqlServerParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .teradataParameters(TeradataParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .build()))
         .awsAccountId("awsAccountId")
         .credentials(DataSourceCredentialsProperty.builder()
                 .copySourceArn("copySourceArn")
                 .credentialPair(CredentialPairProperty.builder()
                         .password("password")
                         .username("username")
                         // the properties below are optional
                         .alternateDataSourceParameters(List.of(DataSourceParametersProperty.builder()
                                 .amazonElasticsearchParameters(AmazonElasticsearchParametersProperty.builder()
                                         .domain("domain")
                                         .build())
                                 .amazonOpenSearchParameters(AmazonOpenSearchParametersProperty.builder()
                                         .domain("domain")
                                         .build())
                                 .athenaParameters(AthenaParametersProperty.builder()
                                         .roleArn("roleArn")
                                         .workGroup("workGroup")
                                         .build())
                                 .auroraParameters(AuroraParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .auroraPostgreSqlParameters(AuroraPostgreSqlParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .databricksParameters(DatabricksParametersProperty.builder()
                                         .host("host")
                                         .port(123)
                                         .sqlEndpointPath("sqlEndpointPath")
                                         .build())
                                 .mariaDbParameters(MariaDbParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .mySqlParameters(MySqlParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .oracleParameters(OracleParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .postgreSqlParameters(PostgreSqlParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .prestoParameters(PrestoParametersProperty.builder()
                                         .catalog("catalog")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .rdsParameters(RdsParametersProperty.builder()
                                         .database("database")
                                         .instanceId("instanceId")
                                         .build())
                                 .redshiftParameters(RedshiftParametersProperty.builder()
                                         .database("database")
                                         // the properties below are optional
                                         .clusterId("clusterId")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .s3Parameters(S3ParametersProperty.builder()
                                         .manifestFileLocation(ManifestFileLocationProperty.builder()
                                                 .bucket("bucket")
                                                 .key("key")
                                                 .build())
                                         // the properties below are optional
                                         .roleArn("roleArn")
                                         .build())
                                 .snowflakeParameters(SnowflakeParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .warehouse("warehouse")
                                         .build())
                                 .sparkParameters(SparkParametersProperty.builder()
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .sqlServerParameters(SqlServerParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .teradataParameters(TeradataParametersProperty.builder()
                                         .database("database")
                                         .host("host")
                                         .port(123)
                                         .build())
                                 .build()))
                         .build())
                 .secretArn("secretArn")
                 .build())
         .dataSourceId("dataSourceId")
         .dataSourceParameters(DataSourceParametersProperty.builder()
                 .amazonElasticsearchParameters(AmazonElasticsearchParametersProperty.builder()
                         .domain("domain")
                         .build())
                 .amazonOpenSearchParameters(AmazonOpenSearchParametersProperty.builder()
                         .domain("domain")
                         .build())
                 .athenaParameters(AthenaParametersProperty.builder()
                         .roleArn("roleArn")
                         .workGroup("workGroup")
                         .build())
                 .auroraParameters(AuroraParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .auroraPostgreSqlParameters(AuroraPostgreSqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .databricksParameters(DatabricksParametersProperty.builder()
                         .host("host")
                         .port(123)
                         .sqlEndpointPath("sqlEndpointPath")
                         .build())
                 .mariaDbParameters(MariaDbParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .mySqlParameters(MySqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .oracleParameters(OracleParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .postgreSqlParameters(PostgreSqlParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .prestoParameters(PrestoParametersProperty.builder()
                         .catalog("catalog")
                         .host("host")
                         .port(123)
                         .build())
                 .rdsParameters(RdsParametersProperty.builder()
                         .database("database")
                         .instanceId("instanceId")
                         .build())
                 .redshiftParameters(RedshiftParametersProperty.builder()
                         .database("database")
                         // the properties below are optional
                         .clusterId("clusterId")
                         .host("host")
                         .port(123)
                         .build())
                 .s3Parameters(S3ParametersProperty.builder()
                         .manifestFileLocation(ManifestFileLocationProperty.builder()
                                 .bucket("bucket")
                                 .key("key")
                                 .build())
                         // the properties below are optional
                         .roleArn("roleArn")
                         .build())
                 .snowflakeParameters(SnowflakeParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .warehouse("warehouse")
                         .build())
                 .sparkParameters(SparkParametersProperty.builder()
                         .host("host")
                         .port(123)
                         .build())
                 .sqlServerParameters(SqlServerParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .teradataParameters(TeradataParametersProperty.builder()
                         .database("database")
                         .host("host")
                         .port(123)
                         .build())
                 .build())
         .errorInfo(DataSourceErrorInfoProperty.builder()
                 .message("message")
                 .type("type")
                 .build())
         .name("name")
         .permissions(List.of(ResourcePermissionProperty.builder()
                 .actions(List.of("actions"))
                 .principal("principal")
                 .build()))
         .sslProperties(SslPropertiesProperty.builder()
                 .disableSsl(false)
                 .build())
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .type("type")
         .vpcConnectionProperties(VpcConnectionPropertiesProperty.builder()
                 .vpcConnectionArn("vpcConnectionArn")
                 .build())
         .build();
 
  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.
  • Constructor Details

    • CfnDataSource

      protected CfnDataSource(software.amazon.jsii.JsiiObjectRef objRef)
    • CfnDataSource

      protected CfnDataSource(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
    • CfnDataSource

      @Stability(Stable) public CfnDataSource(@NotNull Construct scope, @NotNull String id, @Nullable CfnDataSourceProps props)
      Create a new AWS::QuickSight::DataSource.

      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
      props -
      • resource properties.
    • CfnDataSource

      @Stability(Stable) public CfnDataSource(@NotNull Construct scope, @NotNull String id)
      Create a new AWS::QuickSight::DataSource.

      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector -
      • tree inspector to collect and process attributes.
      This parameter is required.
    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.
    • getAttrArn

      @Stability(Stable) @NotNull public String getAttrArn()
      The Amazon Resource Name (ARN) of the dataset.
    • getAttrCreatedTime

      @Stability(Stable) @NotNull public String getAttrCreatedTime()
      The time that this data source was created.
    • getAttrLastUpdatedTime

      @Stability(Stable) @NotNull public String getAttrLastUpdatedTime()
      The last time that this data source was updated.
    • getAttrStatus

      @Stability(Stable) @NotNull public String getAttrStatus()
      The HTTP status of the request.
    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource
    • getTags

      @Stability(Stable) @NotNull public TagManager getTags()
      Contains a map of the key-value pairs for the resource tag or tags assigned to the data source.
    • getAlternateDataSourceParameters

      @Stability(Stable) @Nullable public Object getAlternateDataSourceParameters()
      A set of alternate data source parameters that you want to share for the credentials stored with this data source.

      The credentials are applied in tandem with the data source parameters when you copy a data source by using a create or update request. The API operation compares the DataSourceParameters structure that's in the request with the structures in the AlternateDataSourceParameters allow list. If the structures are an exact match, the request is allowed to use the credentials from this existing data source. If the AlternateDataSourceParameters list is null, the Credentials originally used with this DataSourceParameters are automatically allowed.

    • setAlternateDataSourceParameters

      @Stability(Stable) public void setAlternateDataSourceParameters(@Nullable IResolvable value)
      A set of alternate data source parameters that you want to share for the credentials stored with this data source.

      The credentials are applied in tandem with the data source parameters when you copy a data source by using a create or update request. The API operation compares the DataSourceParameters structure that's in the request with the structures in the AlternateDataSourceParameters allow list. If the structures are an exact match, the request is allowed to use the credentials from this existing data source. If the AlternateDataSourceParameters list is null, the Credentials originally used with this DataSourceParameters are automatically allowed.

    • setAlternateDataSourceParameters

      @Stability(Stable) public void setAlternateDataSourceParameters(@Nullable List<Object> value)
      A set of alternate data source parameters that you want to share for the credentials stored with this data source.

      The credentials are applied in tandem with the data source parameters when you copy a data source by using a create or update request. The API operation compares the DataSourceParameters structure that's in the request with the structures in the AlternateDataSourceParameters allow list. If the structures are an exact match, the request is allowed to use the credentials from this existing data source. If the AlternateDataSourceParameters list is null, the Credentials originally used with this DataSourceParameters are automatically allowed.

    • getAwsAccountId

      @Stability(Stable) @Nullable public String getAwsAccountId()
      The AWS account ID.
    • setAwsAccountId

      @Stability(Stable) public void setAwsAccountId(@Nullable String value)
      The AWS account ID.
    • getCredentials

      @Stability(Stable) @Nullable public Object getCredentials()
      The credentials Amazon QuickSight that uses to connect to your underlying source.

      Currently, only credentials based on user name and password are supported.

    • setCredentials

      @Stability(Stable) public void setCredentials(@Nullable IResolvable value)
      The credentials Amazon QuickSight that uses to connect to your underlying source.

      Currently, only credentials based on user name and password are supported.

    • setCredentials

      @Stability(Stable) public void setCredentials(@Nullable CfnDataSource.DataSourceCredentialsProperty value)
      The credentials Amazon QuickSight that uses to connect to your underlying source.

      Currently, only credentials based on user name and password are supported.

    • getDataSourceId

      @Stability(Stable) @Nullable public String getDataSourceId()
      An ID for the data source.

      This ID is unique per AWS Region for each AWS account.

    • setDataSourceId

      @Stability(Stable) public void setDataSourceId(@Nullable String value)
      An ID for the data source.

      This ID is unique per AWS Region for each AWS account.

    • getDataSourceParameters

      @Stability(Stable) @Nullable public Object getDataSourceParameters()
      The parameters that Amazon QuickSight uses to connect to your underlying source.
    • setDataSourceParameters

      @Stability(Stable) public void setDataSourceParameters(@Nullable IResolvable value)
      The parameters that Amazon QuickSight uses to connect to your underlying source.
    • setDataSourceParameters

      @Stability(Stable) public void setDataSourceParameters(@Nullable CfnDataSource.DataSourceParametersProperty value)
      The parameters that Amazon QuickSight uses to connect to your underlying source.
    • getErrorInfo

      @Stability(Stable) @Nullable public Object getErrorInfo()
      Error information from the last update or the creation of the data source.
    • setErrorInfo

      @Stability(Stable) public void setErrorInfo(@Nullable IResolvable value)
      Error information from the last update or the creation of the data source.
    • setErrorInfo

      @Stability(Stable) public void setErrorInfo(@Nullable CfnDataSource.DataSourceErrorInfoProperty value)
      Error information from the last update or the creation of the data source.
    • getName

      @Stability(Stable) @Nullable public String getName()
      A display name for the data source.
    • setName

      @Stability(Stable) public void setName(@Nullable String value)
      A display name for the data source.
    • getPermissions

      @Stability(Stable) @Nullable public Object getPermissions()
      A list of resource permissions on the data source.
    • setPermissions

      @Stability(Stable) public void setPermissions(@Nullable IResolvable value)
      A list of resource permissions on the data source.
    • setPermissions

      @Stability(Stable) public void setPermissions(@Nullable List<Object> value)
      A list of resource permissions on the data source.
    • getSslProperties

      @Stability(Stable) @Nullable public Object getSslProperties()
      Secure Socket Layer (SSL) properties that apply when Amazon QuickSight connects to your underlying source.
    • setSslProperties

      @Stability(Stable) public void setSslProperties(@Nullable IResolvable value)
      Secure Socket Layer (SSL) properties that apply when Amazon QuickSight connects to your underlying source.
    • setSslProperties

      @Stability(Stable) public void setSslProperties(@Nullable CfnDataSource.SslPropertiesProperty value)
      Secure Socket Layer (SSL) properties that apply when Amazon QuickSight connects to your underlying source.
    • getType

      @Stability(Stable) @Nullable public String getType()
      The type of the data source. To return a list of all data sources, use ListDataSources .

      Use AMAZON_ELASTICSEARCH for Amazon OpenSearch Service.

    • setType

      @Stability(Stable) public void setType(@Nullable String value)
      The type of the data source. To return a list of all data sources, use ListDataSources .

      Use AMAZON_ELASTICSEARCH for Amazon OpenSearch Service.

    • getVpcConnectionProperties

      @Stability(Stable) @Nullable public Object getVpcConnectionProperties()
      Use this parameter only when you want Amazon QuickSight to use a VPC connection when connecting to your underlying source.
    • setVpcConnectionProperties

      @Stability(Stable) public void setVpcConnectionProperties(@Nullable IResolvable value)
      Use this parameter only when you want Amazon QuickSight to use a VPC connection when connecting to your underlying source.
    • setVpcConnectionProperties

      @Stability(Stable) public void setVpcConnectionProperties(@Nullable CfnDataSource.VpcConnectionPropertiesProperty value)
      Use this parameter only when you want Amazon QuickSight to use a VPC connection when connecting to your underlying source.