Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . quicksight ]

create-data-source

Description

Creates a data source.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  create-data-source
--aws-account-id <value>
--data-source-id <value>
--name <value>
--type <value>
[--data-source-parameters <value>]
[--credentials <value>]
[--permissions <value>]
[--vpc-connection-properties <value>]
[--ssl-properties <value>]
[--tags <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--aws-account-id (string)

The AWS account ID.

--data-source-id (string)

An ID for the data source. This ID is unique per AWS Region for each AWS account.

--name (string)

A display name for the data source.

--type (string)

The type of the data source. Currently, the supported types for this operation are: ATHENA, AURORA, AURORA_POSTGRESQL, MARIADB, MYSQL, POSTGRESQL, PRESTO, REDSHIFT, S3, SNOWFLAKE, SPARK, SQLSERVER, TERADATA . Use ListDataSources to return a list of all data sources.

Possible values:

  • ADOBE_ANALYTICS
  • AMAZON_ELASTICSEARCH
  • ATHENA
  • AURORA
  • AURORA_POSTGRESQL
  • AWS_IOT_ANALYTICS
  • GITHUB
  • JIRA
  • MARIADB
  • MYSQL
  • POSTGRESQL
  • PRESTO
  • REDSHIFT
  • S3
  • SALESFORCE
  • SERVICENOW
  • SNOWFLAKE
  • SPARK
  • SQLSERVER
  • TERADATA
  • TWITTER

--data-source-parameters (structure)

The parameters that QuickSight uses to connect to your underlying source.

Shorthand Syntax:

AmazonElasticsearchParameters={Domain=string},AthenaParameters={WorkGroup=string},AuroraParameters={Host=string,Port=integer,Database=string},AuroraPostgreSqlParameters={Host=string,Port=integer,Database=string},AwsIotAnalyticsParameters={DataSetName=string},JiraParameters={SiteBaseUrl=string},MariaDbParameters={Host=string,Port=integer,Database=string},MySqlParameters={Host=string,Port=integer,Database=string},PostgreSqlParameters={Host=string,Port=integer,Database=string},PrestoParameters={Host=string,Port=integer,Catalog=string},RdsParameters={InstanceId=string,Database=string},RedshiftParameters={Host=string,Port=integer,Database=string,ClusterId=string},S3Parameters={ManifestFileLocation={Bucket=string,Key=string}},ServiceNowParameters={SiteBaseUrl=string},SnowflakeParameters={Host=string,Database=string,Warehouse=string},SparkParameters={Host=string,Port=integer},SqlServerParameters={Host=string,Port=integer,Database=string},TeradataParameters={Host=string,Port=integer,Database=string},TwitterParameters={Query=string,MaxRows=integer}

JSON Syntax:

{
  "AmazonElasticsearchParameters": {
    "Domain": "string"
  },
  "AthenaParameters": {
    "WorkGroup": "string"
  },
  "AuroraParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "AuroraPostgreSqlParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "AwsIotAnalyticsParameters": {
    "DataSetName": "string"
  },
  "JiraParameters": {
    "SiteBaseUrl": "string"
  },
  "MariaDbParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "MySqlParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "PostgreSqlParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "PrestoParameters": {
    "Host": "string",
    "Port": integer,
    "Catalog": "string"
  },
  "RdsParameters": {
    "InstanceId": "string",
    "Database": "string"
  },
  "RedshiftParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string",
    "ClusterId": "string"
  },
  "S3Parameters": {
    "ManifestFileLocation": {
      "Bucket": "string",
      "Key": "string"
    }
  },
  "ServiceNowParameters": {
    "SiteBaseUrl": "string"
  },
  "SnowflakeParameters": {
    "Host": "string",
    "Database": "string",
    "Warehouse": "string"
  },
  "SparkParameters": {
    "Host": "string",
    "Port": integer
  },
  "SqlServerParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "TeradataParameters": {
    "Host": "string",
    "Port": integer,
    "Database": "string"
  },
  "TwitterParameters": {
    "Query": "string",
    "MaxRows": integer
  }
}

--credentials (structure)

The credentials QuickSight that uses to connect to your underlying source. Currently, only credentials based on user name and password are supported.

Shorthand Syntax:

CredentialPair={Username=string,Password=string}

JSON Syntax:

{
  "CredentialPair": {
    "Username": "string",
    "Password": "string"
  }
}

--permissions (list)

A list of resource permissions on the data source.

Shorthand Syntax:

Principal=string,Actions=string,string ...

JSON Syntax:

[
  {
    "Principal": "string",
    "Actions": ["string", ...]
  }
  ...
]

--vpc-connection-properties (structure)

Use this parameter only when you want QuickSight to use a VPC connection when connecting to your underlying source.

Shorthand Syntax:

VpcConnectionArn=string

JSON Syntax:

{
  "VpcConnectionArn": "string"
}

--ssl-properties (structure)

Secure Socket Layer (SSL) properties that apply when QuickSight connects to your underlying source.

Shorthand Syntax:

DisableSsl=boolean

JSON Syntax:

{
  "DisableSsl": true|false
}

--tags (list)

Contains a map of the key-value pairs for the resource tag or tags assigned to the data source.

Shorthand Syntax:

Key=string,Value=string ...

JSON Syntax:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

Arn -> (string)

The Amazon Resource Name (ARN) of the data source.

DataSourceId -> (string)

The ID of the data source. This ID is unique per AWS Region for each AWS account.

CreationStatus -> (string)

The status of creating the data source.

RequestId -> (string)

The AWS request ID for this operation.

Status -> (integer)

The HTTP status of the request.