UpdateAnalysis - Amazon QuickSight
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

UpdateAnalysis

Aktualisiert eine Analyse in Amazon QuickSight

Anforderungssyntax

PUT /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "ThemeArn": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AnalysisId

Die ID für die Analyse, die Sie aktualisieren. Diese ID wird in der URL der Analyse angezeigt.

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Pattern: [\w\-]+

Erforderlich: Ja

AwsAccountId

Die ID derAWSKonto, das die Analyse enthält, die Sie aktualisieren.

Längenbeschränkungen: Feste Länge von 12.

Pattern: ^[0-9]{12}$

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

Name

Ein beschreibender Name für die Analyse, die Sie aktualisieren. Dieser Name wird für die Analyse im Amazon angezeigt QuickSight console.

Type: String

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Ja

SourceEntity

Eine Quellentität, die für die Analyse verwendet werden soll, die Sie aktualisieren. Diese Metadatenstruktur enthält Details, die eine Quellvorlage und einen oder mehrere Datensätze beschreiben.

Typ: AnalysisSourceEntity Objekt

Erforderlich: Ja

Parameters

Die Parameter benennen und überschreiben Werte, die Sie verwenden möchten. Eine Analyse kann einen beliebigen Parametertyp haben, und einige Parameter akzeptieren möglicherweise mehrere Werte.

Typ: Parameters Objekt

Erforderlich: Nein

ThemeArn

Der Ressourcen (ARN) für das Design, die auf die von Ihnen erstellte Analyse angewendet wird. Um das Design im Amazon zu sehen QuickSight Konsole, stellen Sie sicher, dass Sie Zugriff darauf haben.

Type: String

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 Status
Content-type: application/json

{
   "AnalysisId": "string",
   "Arn": "string",
   "RequestId": "string",
   "UpdateStatus": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück.

Status

Der HTTP-Status der Anforderung.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

AnalysisId

Die ID der Analyse.

Type: String

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Pattern: [\w\-]+

Arn

Der ARN der Analyse, die Sie aktualisieren.

Type: String

RequestId

DieAWSAnforderungsnummer für diese Operation.

Type: String

UpdateStatus

Der Aktualisierungsstatus der letzten Aktualisierung, die an der Analyse vorgenommen wurde.

Type: String

Zulässige Werte: CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

Fehler

Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unterHäufige Fehler.

ConflictException

Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen.

HTTP Status Code: 409

InternalFailureException

Es ist ein interner Fehler aufgetreten.

HTTP Status Code: 500

InvalidParameterValueException

Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist.

HTTP Status Code: 400

ResourceExistsException

Die angegebene Ressource ist bereits vorhanden.

HTTP Status Code: 409

ResourceNotFoundException

Mindestens eine Ressource kann nicht gefunden werden.

HTTP Status Code: 404

ThrottlingException

Der Zugriff wird gedrosselt

HTTP Status Code: 429

UnsupportedUserEditionException

Dieser Fehler zeigt an, dass Sie eine Operation bei Amazon durchführen QuickSightAbonnement, bei dem die Edition keine Unterstützung für diesen Vorgang enthält. Amazon QuickSight verfügt derzeit über eine Standard Edition und eine Enterprise Edition. Nicht jede Operation und Funktion ist in jeder Version verfügbar ist.

HTTP Status Code: 403

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: