Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
UpdateDataSource
Met à jour une source de données.
Syntaxe de la demande
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"
}
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- AwsAccountId
-
L'ID de compte AWS.
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$Obligatoire : Oui
- DataSourceId
-
ID de la source de données. Cet ID est uniqueRégion AWSpour chaqueAWS.
Obligatoire : Oui
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- Name
-
Nom d'affichage de la source de données.
Type : Chaîne
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 128.
Obligatoire : Oui
- Credentials
-
Les informations d'identification qu'Amazon QuickSight qui utilise pour se connecter à votre source sous-jacente. Actuellement, seules les informations d'identification basées sur le nom d'utilisateur et le mot de passe sont prises
Type : objet DataSourceCredentials
Obligatoire : Non
- DataSourceParameters
-
Les paramètres qu'Amazon QuickSight utilise pour se connecter à votre source sous-jacente.
Type : objet DataSourceParameters
Obligatoire : Non
- SslProperties
-
Propriétés SSL (Secure Socket Layer) qui s'appliquent lorsqu'Amazon QuickSight se connecte à votre source sous-jacente.
Type : objet SslProperties
Obligatoire : Non
- VpcConnectionProperties
-
Utilisez ce paramètre uniquement lorsque vous souhaitez Amazon QuickSight pour utiliser une connexion VPC lorsqu'il se connecte à votre source sous-jacente.
Type : objet VpcConnectionProperties
Obligatoire : Non
Syntaxe de la réponse
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"DataSourceId": "string",
"RequestId": "string",
"UpdateStatus": "string"
}Eléments de réponse
Si l'action aboutit, le service renvoie la réponse HTTP suivante.
- Status
-
Le statut HTTP de la requête.
Les données suivantes sont renvoyées au format JSON par le service.
- Arn
-
Nom de ressource Amazon (ARN) de la source de données.
Type : Chaîne
- DataSourceId
-
ID de la source de données. Cet ID est uniqueRégion AWSpour chaqueAWS.
Type : Chaîne
- RequestId
-
LeAWSID de demande pour cette opération.
Type : Chaîne
- UpdateStatus
-
État de mise à jour de la dernière mise à jour de la source de données.
Type : Chaîne
Valeurs valides :
CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- AccessDeniedException
-
Vous n'avez pas accès à cet article. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les bonnes clés d'accès.
HTTP Status tus tus tus tus 401
- ConflictException
-
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.
HTTP Status tus tus tus tus 409
- InternalFailureException
-
Une défaillance interne s'est produite.
HTTP Status tus tus tus tus 500
- InvalidParameterValueException
-
La valeur d'un ou de plusieurs paramètres n'est pas valide.
HTTP Status tus tus tus tus 400
- ResourceNotFoundException
-
Une ou plusieurs ressources n'ont pas pu être trouvées.
HTTP Status tus tus tus tus 404
- ThrottlingException
-
L'accès est limité.
HTTP Status tus tus tus tus 429
Exemples
Exemple
Cet exemple illustre une utilisation de UpdateDataSource.
Exemple de demande
PUT /accounts/{AwsAccountId}/data-sources/{DataSourceId} HTTP/1.1
Content-type: application/jsonVoir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
