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
Aggiorna un'origine dati.
Sintassi della richiesta
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:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
ID dell'account AWS.
Vincoli di lunghezza: Lunghezza fissa di 12.
Modello:
^[0-9]{12}$Required: Sì
- DataSourceId
-
ID dell'origine dati. Questo ID è univoco perRegione AWSper ogniAWSconto.
Required: Sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- Name
-
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
-
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 oggetto
Required: No
- DataSourceParameters
-
I parametri che Amazon QuickSight utilizza per connettersi all'origine sottostante.
Tipo: DataSourceParameters oggetto
Required: No
- SslProperties
-
Proprietà SSL (Secure Socket Layer) che si applicano quando Amazon QuickSight si connette alla fonte sottostante.
Tipo: SslProperties oggetto
Required: No
- VpcConnectionProperties
-
Utilizza questo parametro solo quando si desidera Amazon QuickSight per usare una connessione VPC durante la connessione all'origine sottostante.
Tipo: VpcConnectionProperties oggetto
Required: No
Sintassi della risposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"DataSourceId": "string",
"RequestId": "string",
"UpdateStatus": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.
- Status
-
Lo stato HTTP della richiesta.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Arn
-
L'Amazon Resource Name (ARN) dell'origine dati.
Type: Stringa
- DataSourceId
-
ID dell'origine dati. Questo ID è univoco perRegione AWSper ogniAWSconto.
Type: Stringa
- RequestId
-
LaAWSID della richiesta per questa operazione.
Type: Stringa
- UpdateStatus
-
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
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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
Esempio
Questo esempio illustra un utilizzo di UpdateDataSource.
Richiesta di esempio
PUT /accounts/{AwsAccountId}/data-sources/{DataSourceId} HTTP/1.1
Content-type: application/jsonVedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
