Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# CreateDataSource
<a name="API_CreateDataSource"></a>

Crea un'origine dati.

## Sintassi della richiesta
<a name="API_CreateDataSource_RequestSyntax"></a>

```
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"
   }
}
```

## Parametri della richiesta URI:
<a name="API_CreateDataSource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-AwsAccountId"></a>
ID dell'account AWS.  
Vincoli di lunghezza: vincoli di lunghezza Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Obbligatorio Sì

## Corpo della richiesta
<a name="API_CreateDataSource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [DataSourceId](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-DataSourceId"></a>
ID per l'origine dati. Questo ID è univoco perRegione AWSper ogni)AWSconto.   
Type: Stringa  
Obbligatorio Sì

 ** [Name](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-Name"></a>
Un nome visualizzato per l'origine dati.  
Type: Stringa  
Vincoli di lunghezza: vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Obbligatorio Sì

 ** [Type](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-Type"></a>
Il tipo di origine dati. Per restituire un elenco di tutte le origini dati, utilizzare tutte le fonti`ListDataSources`.  
Utilizza`AMAZON_ELASTICSEARCH`per Amazon OpenSearch Servizio.  
Type: Stringa  
Valori validi: ` 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`   
Obbligatorio Sì

 ** [Credentials](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-Credentials"></a>
Le credenziali Amazon QuickSight che si connette all'origine sottostante. Attualmente sono supportate solo le credenziali basate su nome utente e password.  
Tipo: [DataSourceCredentials](API_DataSourceCredentials.md) oggetto  
Obbligatorio No

 ** [DataSourceParameters](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-DataSourceParameters"></a>
I parametri che Amazon QuickSight utilizza per connettersi all'origine sottostante.  
Tipo: [DataSourceParameters](API_DataSourceParameters.md) oggetto  
Obbligatorio No

 ** [Permissions](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-Permissions"></a>
Un elenco di autorizzazioni per le risorse per l'origine dati.  
Type: Matrice di array[ResourcePermission](API_ResourcePermission.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi.  
Obbligatorio No

 ** [SslProperties](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-SslProperties"></a>
Proprietà SSL (Secure Socket Socket Socket) che si connette quando QuickSight si connette alla fonte sottostante.  
Tipo: [SslProperties](API_SslProperties.md) oggetto  
Obbligatorio No

 ** [Tags](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-Tags"></a>
Contiene una mappa delle coppie chiave-valore per il tag o i tag di risorsa assegnati all'origine dati.  
Type: Matrice di array[Tag](API_Tag.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 200 elementi.  
Obbligatorio No

 ** [VpcConnectionProperties](#API_CreateDataSource_RequestSyntax) **   <a name="QS-CreateDataSource-request-VpcConnectionProperties"></a>
Utilizza questo parametro solo quando si desidera che Amazon si utilizzi QuickSight per usare una connessione VPC durante la connessione all'origine sottostante.  
Tipo: [VpcConnectionProperties](API_VpcConnectionProperties.md) oggetto  
Obbligatorio No

## Sintassi della risposta
<a name="API_CreateDataSource_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "DataSourceId": "string",
   "RequestId": "string"
}
```

## Elementi di risposta
<a name="API_CreateDataSource_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

 ** [Status](#API_CreateDataSource_ResponseSyntax) **   <a name="QS-CreateDataSource-response-Status"></a>
Lo stato HTTP della richiesta.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_CreateDataSource_ResponseSyntax) **   <a name="QS-CreateDataSource-response-Arn"></a>
L'Amazon Resource Name (ARN) dell'origine dati.  
Type: Stringa

 ** [CreationStatus](#API_CreateDataSource_ResponseSyntax) **   <a name="QS-CreateDataSource-response-CreationStatus"></a>
Lo stato della creazione dell'origine dati.  
Type: Stringa  
Valori validi: ` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [DataSourceId](#API_CreateDataSource_ResponseSyntax) **   <a name="QS-CreateDataSource-response-DataSourceId"></a>
ID dell'origine dati. Questo ID è univoco perRegione AWSper ogni)AWSconto.  
Type: Stringa

 ** [RequestId](#API_CreateDataSource_ResponseSyntax) **   <a name="QS-CreateDataSource-response-RequestId"></a>
LaAWSID della richiesta per questa operazione.  
Type: Stringa

## Errori
<a name="API_CreateDataSource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le autorizzazioni corrette e che le autorizzazioni corrette.  
Codice di stato HTTP: HTTP: 401

 ** ConflictException **   
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.  
Codice di stato HTTP: HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno.  
Codice di stato HTTP: HTTP: 500

 ** InvalidParameterValueException **   
Uno o più parametri hanno un valore non valido.  
Codice di stato HTTP: HTTP: 400

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: HTTP: 409

 ** ResourceExistsException **   
La risorsa specificata esiste già.   
Codice di stato HTTP: HTTP: 409

 ** ResourceNotFoundException **   
Uno o più risorse non sono state trovate.  
Codice di stato HTTP: HTTP: 404

 ** ThrottlingException **   
L'accesso è limitato.  
Codice di stato HTTP: HTTP: 429

## Esempi
<a name="API_CreateDataSource_Examples"></a>

### Esempio
<a name="API_CreateDataSource_Example_1"></a>

Questo esempio illustra un utilizzo di CreateDataSource.

#### Richiesta di esempio
<a name="API_CreateDataSource_Example_1_Request"></a>

```
POST /accounts/{AwsAccountId}/data-sources HTTP/1.1 Content-type: application/json
```

## Vedi anche
<a name="API_CreateDataSource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateDataSource) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateDataSource) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateDataSource) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateDataSource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateDataSource) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateDataSource) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateDataSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateDataSource)