

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à.

# UpdateDataSource
<a name="API_UpdateDataSource"></a>

Aggiorna un'origine dati.

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

```
PUT /accounts/AwsAccountId/data-sources/DataSourceId 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"
      }
   },
   "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",
   "SslProperties": { 
      "DisableSsl": boolean
   },
   "VpcConnectionProperties": { 
      "VpcConnectionArn": "string"
   }
}
```

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

La richiesta utilizza i seguenti parametri URI.

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

 ** [DataSourceId](#API_UpdateDataSource_RequestSyntax) **   <a name="QS-UpdateDataSource-request-DataSourceId"></a>
ID dell'origine dati. Questo ID è univoco perRegione AWSper ogniAWSconto.   
Required: Sì

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

La richiesta accetta i seguenti dati in formato JSON.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 ** [UpdateStatus](#API_UpdateDataSource_ResponseSyntax) **   <a name="QS-UpdateDataSource-response-UpdateStatus"></a>
Lo stato di aggiornamento dell'ultimo aggiornamento dell'origine dati.  
Type: Stringa  
Valori validi: ` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

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

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

 ** AccessDeniedException **   
Non hai l'accesso a questo articolo. 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 policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.  
Codice di stato HTTP: 401

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

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

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

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

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

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

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

Questo esempio illustra un utilizzo di UpdateDataSource.

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

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

## Vedi anche
<a name="API_UpdateDataSource_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/UpdateDataSource) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateDataSource) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateDataSource) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateDataSource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateDataSource) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateDataSource) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateDataSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateDataSource) 