Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # CreateDataSource Erstellt eine Datenquelle. ## Anforderungssyntax ``` POST /accounts/AwsAccountId/data-sources HTTP/1.1 Content-type: application/json { "Credentials": { "CopySourceArn": "string", "CredentialPair": { "AlternateDataSourceParameters": [ { "AmazonElasticsearchParameters": { "Domain": "string" }, "AmazonOpenSearchParameters": { "Domain": "string" }, "AthenaParameters": { "WorkGroup": "string" }, "AuroraParameters": { "Database": "string", "Host": "string", "Port": number }, "AuroraPostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "AwsIotAnalyticsParameters": { "DataSetName": "string" }, "ExasolParameters": { "Host": "string", "Port": number }, "JiraParameters": { "SiteBaseUrl": "string" }, "MariaDbParameters": { "Database": "string", "Host": "string", "Port": number }, "MySqlParameters": { "Database": "string", "Host": "string", "Port": number }, "OracleParameters": { "Database": "string", "Host": "string", "Port": number }, "PostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "PrestoParameters": { "Catalog": "string", "Host": "string", "Port": number }, "RdsParameters": { "Database": "string", "InstanceId": "string" }, "RedshiftParameters": { "ClusterId": "string", "Database": "string", "Host": "string", "Port": number }, "S3Parameters": { "ManifestFileLocation": { "Bucket": "string", "Key": "string" } }, "ServiceNowParameters": { "SiteBaseUrl": "string" }, "SnowflakeParameters": { "Database": "string", "Host": "string", "Warehouse": "string" }, "SparkParameters": { "Host": "string", "Port": number }, "SqlServerParameters": { "Database": "string", "Host": "string", "Port": number }, "TeradataParameters": { "Database": "string", "Host": "string", "Port": number }, "TwitterParameters": { "MaxRows": number, "Query": "string" } } ], "Password": "string", "Username": "string" } }, "DataSourceId": "string", "DataSourceParameters": { "AmazonElasticsearchParameters": { "Domain": "string" }, "AmazonOpenSearchParameters": { "Domain": "string" }, "AthenaParameters": { "WorkGroup": "string" }, "AuroraParameters": { "Database": "string", "Host": "string", "Port": number }, "AuroraPostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "AwsIotAnalyticsParameters": { "DataSetName": "string" }, "ExasolParameters": { "Host": "string", "Port": number }, "JiraParameters": { "SiteBaseUrl": "string" }, "MariaDbParameters": { "Database": "string", "Host": "string", "Port": number }, "MySqlParameters": { "Database": "string", "Host": "string", "Port": number }, "OracleParameters": { "Database": "string", "Host": "string", "Port": number }, "PostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "PrestoParameters": { "Catalog": "string", "Host": "string", "Port": number }, "RdsParameters": { "Database": "string", "InstanceId": "string" }, "RedshiftParameters": { "ClusterId": "string", "Database": "string", "Host": "string", "Port": number }, "S3Parameters": { "ManifestFileLocation": { "Bucket": "string", "Key": "string" } }, "ServiceNowParameters": { "SiteBaseUrl": "string" }, "SnowflakeParameters": { "Database": "string", "Host": "string", "Warehouse": "string" }, "SparkParameters": { "Host": "string", "Port": number }, "SqlServerParameters": { "Database": "string", "Host": "string", "Port": number }, "TeradataParameters": { "Database": "string", "Host": "string", "Port": number }, "TwitterParameters": { "MaxRows": number, "Query": "string" } }, "Name": "string", "Permissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "SslProperties": { "DisableSsl": boolean }, "Tags": [ { "Key": "string", "Value": "string" } ], "Type": "string", "VpcConnectionProperties": { "VpcConnectionArn": "string" } } ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [AwsAccountId](#API_CreateDataSource_RequestSyntax) ** Die AWS-Konto-ID. Längenbeschränkungen:: Feste Länge von 12. Pattern: `^[0-9]{12}$` Erforderlich:: Ja ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [DataSourceId](#API_CreateDataSource_RequestSyntax) ** Eine ID der Datenquelle. Diese ID muss eindeutig seinAWS-Regionfür jedenAWSKonto. Type: String Erforderlich:: Ja ** [Name](#API_CreateDataSource_RequestSyntax) ** Ein Anzeigename für die Datenquelle. Type: String Längenbeschränkungen:: Mindestlänge 1. Maximale Länge beträgt 128 Zeichen. Erforderlich:: Ja ** [Type](#API_CreateDataSource_RequestSyntax) ** Der Typ der Datenquelle. Um eine Liste aller Datenquellen zurückzugeben, verwenden Sie`ListDataSources`. Verwenden von`AMAZON_ELASTICSEARCH`für Amazon OpenSearch Service. Type: String Zulässige Werte:` ADOBE_ANALYTICS | AMAZON_ELASTICSEARCH | ATHENA | AURORA | AURORA_POSTGRESQL | AWS_IOT_ANALYTICS | GITHUB | JIRA | MARIADB | MYSQL | ORACLE | POSTGRESQL | PRESTO | REDSHIFT | S3 | SALESFORCE | SERVICENOW | SNOWFLAKE | SPARK | SQLSERVER | TERADATA | TWITTER | TIMESTREAM | AMAZON_OPENSEARCH | EXASOL` Erforderlich:: Ja ** [Credentials](#API_CreateDataSource_RequestSyntax) ** Die Anmeldeinformationen Amazon QuickSight das verwendet, um eine Verbindung zu Ihrer zugrunde liegenden Quelle herzustellen. Derzeit werden nur Anmeldeinformationen unterstützt, die auf dem Benutzernamen und dem Kennwort basieren. Typ: [DataSourceCredentials](API_DataSourceCredentials.md) Objekt Erforderlich:: Nein ** [DataSourceParameters](#API_CreateDataSource_RequestSyntax) ** Die Parameter, die Amazon QuickSight verwendet, um eine Verbindung zu Ihrer zugrunde liegenden Quelle herzustellen. Typ: [DataSourceParameters](API_DataSourceParameters.md) Objekt Erforderlich:: Nein ** [Permissions](#API_CreateDataSource_RequestSyntax) ** Eine Liste der Ressourcenberechtigungen für die Datenquelle. Type: Array der[ResourcePermission](API_ResourcePermission.md)Objekte Array Mitglieder:: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl der Elemente = 64 Elemente. Erforderlich:: Nein ** [SslProperties](#API_CreateDataSource_RequestSyntax) ** Secure-Socket-Layer (SSL) -Eigenschaften, die bei Amazon gelten QuickSight verbindet sich mit Ihrer zugrunde liegenden Quelle. Typ: [SslProperties](API_SslProperties.md) Objekt Erforderlich:: Nein ** [Tags](#API_CreateDataSource_RequestSyntax) ** Enthält eine Zuordnung der Schlüssel-Wert-Paare für das oder die Ressourcen-Tags, die der Datenquelle zugewiesen sind. Type: Array der[Tag](API_Tag.md)Objekte Array Mitglieder:: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl der Elemente = 200 Elemente. Erforderlich:: Nein ** [VpcConnectionProperties](#API_CreateDataSource_RequestSyntax) ** Verwenden Sie diesen Parameter nur, wenn Sie Amazon möchten. QuickSight um eine VPC-Verbindung zu Ihrer zugrunde liegenden Quelle zu verwenden. Typ: [VpcConnectionProperties](API_VpcConnectionProperties.md) Objekt Erforderlich:: Nein ## Antwortsyntax ``` HTTP/1.1 Status Content-type: application/json { "Arn": "string", "CreationStatus": "string", "DataSourceId": "string", "RequestId": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück. ** [Status](#API_CreateDataSource_ResponseSyntax) ** Der HTTP-Status der Anforderung. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [Arn](#API_CreateDataSource_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) der Datenquelle. Type: String ** [CreationStatus](#API_CreateDataSource_ResponseSyntax) ** Der Status der Erstellung der Datenquelle. Type: String Zulässige Werte:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` ** [DataSourceId](#API_CreateDataSource_ResponseSyntax) ** Die ID der Datenquelle. Diese ID muss eindeutig seinAWS-Regionfür jedenAWSKonto. Type: String ** [RequestId](#API_CreateDataSource_ResponseSyntax) ** DieAWSdie ID der Anforderung für diese Operation. Type: String ## Fehler Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unter[Häufige Fehler](CommonErrors.md). ** AccessDeniedException ** Sie haben keinen Zugriff auf dieses Element. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight -Service, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden. HTTP Status Code::: 401 ** ConflictException ** Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen. HTTP Status Code::: 409 ** InternalFailureException ** Es ist ein interner Fehler aufgetreten. HTTP Status Code::: 500 ** InvalidParameterValueException ** Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist. HTTP Status Code::: 400 ** LimitExceededException ** Ein Limit wurde überschritten. HTTP Status Code::: 409 ** ResourceExistsException ** Die angegebene Ressource ist bereits vorhanden. HTTP Status Code::: 409 ** ResourceNotFoundException ** Mindestens eine Ressource kann nicht gefunden werden. HTTP Status Code::: 404 ** ThrottlingException ** Der Zugriff wird gedrosselt HTTP Status Code::: 429 ## Beispiele ### Beispiel Dieses Beispiel zeigt eine Verwendung von CreateDataSource. #### Beispielanforderung ``` POST /accounts/{AwsAccountId}/data-sources HTTP/1.1 Content-type: application/json ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateDataSource) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateDataSource) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateDataSource) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateDataSource) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateDataSource) + [AWSSDK-Statusse für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateDataSource) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateDataSource) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateDataSource) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateDataSource)