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.
DeleteAnalysis
Supprime une analyse d'Amazon QuickSight. Vous pouvez éventuellement inclure une fenêtre de récupération pendant laquelle vous pouvez restaurer l'analyse. Si vous ne spécifiez pas de valeur de plage de récupération, l'opération est par défaut de 30 jours. Amazon QuickSight attache uneDeletionTimeestampille sur la réponse qui indique la fin de la fenêtre de récupération. À la fin de la fenêtre de récupération, Amazon QuickSight supprime définitivement l'analyse.
À tout moment avant la fin de la plage de récupération, vous pouvez utiliser laRestoreAnalysisopération de l'API pour supprimer leDeletionTimetamponner et annuler la suppression de l'analyse. L'analyse reste visible dans l'API jusqu'à ce qu'elle soit supprimée. Vous pouvez donc la décrire mais vous ne pouvez pas en créer un modèle.
Une analyse dont la suppression est programmée n'est pas accessible sur Amazon QuickSight console Pour y accéder dans la console, restaurez-le. La suppression d'une analyse ne supprime pas les tableaux de bord que vous publiez à partir de celle-ci.
Syntaxe de la demande
DELETE /accounts/AwsAccountId/analyses/AnalysisId?force-delete-without-recovery=ForceDeleteWithoutRecovery&recovery-window-in-days=RecoveryWindowInDays HTTP/1.1
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- AnalysisId
-
ID de l'analyse que vous supprimez.
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.
Modèle :
[\w\-]+Obligatoire : Oui
- AwsAccountId
-
ID duAWScompte dont vous voulez supprimer une analyse.
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$Obligatoire : Oui
- ForceDeleteWithoutRecovery
-
Cette option est définie par défaut sur la valeur
NoForceDeleteWithoutRecovery. Pour supprimer immédiatement l'analyse, ajoutez leForceDeleteWithoutRecoveryoption. Vous ne pouvez pas restaurer une analyse après l'avoir supprimée. - RecoveryWindowInDays
-
Une valeur qui spécifie le nombre de jours pendant lesquels Amazon QuickSight attend avant de supprimer l'analyse. Vous ne pouvez pas utiliser ce paramètre avec la méthode
ForceDeleteWithoutRecoverydans le même appel d'API. La valeur par défaut est 30.Plage valide : La valeur minimale est de 7. Valeur maximale fixée à 30.
Corps de la requête
La demande n'a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 Status
Content-type: application/json
{
"AnalysisId": "string",
"Arn": "string",
"DeletionTime": number,
"RequestId": "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.
- AnalysisId
-
ID de l'analyse supprimée.
Type : Chaîne
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.
Modèle :
[\w\-]+ - Arn
-
ARN (Amazon Resource Name) de l'analyse supprimée.
Type : Chaîne
- DeletionTime
-
La date et l'heure planifiées pour la suppression de l'analyse.
Type : Horodatage
- RequestId
-
LeAWSID de demande pour cette opération.
Type : Chaîne
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- ConflictException
-
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.
HTTP Status Code : 409
- InternalFailureException
-
Une défaillance interne s'est produite.
HTTP Status Code : 500
- InvalidParameterValueException
-
La valeur d'un ou de plusieurs paramètres n'est pas valide.
HTTP Status Code : 400
- ResourceNotFoundException
-
Une ou plusieurs ressources n'ont pas pu être trouvées.
HTTP Status Code : 404
- ThrottlingException
-
L'accès est limité.
HTTP Status Code : 429
- UnsupportedUserEditionException
-
Cette erreur indique que vous appelez une opération portant sur Amazon. QuickSightabonnement dont l'édition n'inclut pas la prise en charge de cette opération. Amazon Amazon QuickSight dispose actuellement de Standard Edition et Enterprise Edition. Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition.
HTTP Status Code : 403
Voir 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 :
