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.

# UpdateDashboard
<a name="API_UpdateDashboard"></a>

Aktualisiert ein Dashboard in einerAWSKonto.

**Anmerkung**  
Durch das Aktualisieren eines Dashboards wird eine neue Dashboard-Version erstellt, die neue Version wird jedoch nicht sofort veröffentlicht. Sie können die veröffentlichte Version eines Dashboards mit der Status eines Dashboards aktualisieren.` [UpdateDashboardPublishedVersion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPublishedVersion.html) `API-Operation.

## Anforderungssyntax
<a name="API_UpdateDashboard_RequestSyntax"></a>

```
PUT /accounts/AwsAccountId/dashboards/DashboardId HTTP/1.1
Content-type: application/json

{
   "DashboardPublishOptions": { 
      "AdHocFilteringOption": { 
         "AvailabilityStatus": "string"
      },
      "ExportToCSVOption": { 
         "AvailabilityStatus": "string"
      },
      "SheetControlsOption": { 
         "VisibilityState": "string"
      }
   },
   "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",
   "VersionDescription": "string"
}
```

## URI-Anfrageparameter
<a name="API_UpdateDashboard_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [AwsAccountId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-AwsAccountId"></a>
Die ID derAWSKonto, das das Dashboard enthält, das Sie aktualisieren.  
Längenbeschränkungen: Feste Länge von 12.  
Pattern: `^[0-9]{12}$`   
Erforderlich: Ja

 ** [DashboardId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardId"></a>
Die ID für das Dashboard.  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+`   
Erforderlich: Ja

## Anforderungstext
<a name="API_UpdateDashboard_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Name](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Name"></a>
Der Anzeigename des Dashboards.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Erforderlich: Ja

 ** [SourceEntity](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-SourceEntity"></a>
Die Entität, die Sie als Quelle verwenden, wenn Sie das Dashboard aktualisieren. In :`SourceEntity`geben Sie den Objekttyp an, den Sie als Quelle verwenden. Sie können ein Dashboard nur aus einer Vorlage aktualisieren, also verwenden Sie eine`SourceTemplate`-Entität. Wenn Sie ein Dashboard aus einer Analyse aktualisieren müssen, konvertieren Sie die Analyse zunächst in eine Vorlage, indem Sie die` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `API-Operation. Für`SourceTemplate`geben Sie den Amazon-Ressourcenname (ARN) der Quellvorlage an. Die`SourceTemplate`ARN kann beliebige enthaltenAWSKonto und irgendein Amazon QuickSight-unterstütztAWS-Region.   
Verwenden der`DataSetReferences`Entität innerhalb`SourceTemplate`, um die Ersatz-Datensätze für die im Original aufgeführten Platzhalter aufzulisten. Das Schema in jedem Datensatz muss mit seinem Platzhalter übereinstimmen.   
Typ: [DashboardSourceEntity](API_DashboardSourceEntity.md) Objekt  
Erforderlich: Ja

 ** [DashboardPublishOptions](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardPublishOptions"></a>
Optionen zum Veröffentlichen des Dashboards bei der Erstellung:  
+  `AvailabilityStatus`zum`AdHocFilteringOption`- Dieser Status kann sowohl`ENABLED`oder`DISABLED`. Wenn diese Eigenschaft ist auf`DISABLED`, Amazon QuickSight deaktiviert den linken Filterbereich im veröffentlichten Dashboard, der für die (einmalige) Ad-hoc-Filterung verwendet werden kann. Dieser Option ist`ENABLED`standardmäßig. 
+  `AvailabilityStatus`zum`ExportToCSVOption`- Dieser Status kann sowohl`ENABLED`oder`DISABLED`. Die visuelle Option zum Exportieren von Daten in das CSV-Format ist nicht aktiviert, wenn diese Einstellung auf`DISABLED`. Dieser Option ist`ENABLED`standardmäßig. 
+  `VisibilityState`zum`SheetControlsOption`- Dieser Sichtbarkeitsstatus kann entweder`COLLAPSED`oder`EXPANDED`. Dieser Option ist`COLLAPSED`standardmäßig. 
Typ: [DashboardPublishOptions](API_DashboardPublishOptions.md) Objekt  
Erforderlich: Nein

 ** [Parameters](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Parameters"></a>
Eine Struktur, die die Parameter des Dashboards enthält. Dies sind Parameter-Überschreibungen für ein Dashboard. Ein Dashboard kann jede Art von Parametern haben, und einige Parameter akzeptieren möglicherweise mehrere Werte.  
Typ: [Parameters](API_Parameters.md) Objekt  
Erforderlich: Nein

 ** [ThemeArn](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-ThemeArn"></a>
Der Amazon-Ressourcenname (ARN) des Themes, das für dieses Dashboard verwendet wird. Wenn Sie einen Wert für dieses Feld hinzufügen, wird der Wert überschrieben, der Entität ursprünglich zugeordnet war. Der Theme-ARN muss in derselben Eigenschaft vorhanden seinAWSKonto, in dem Sie das Dashboard erstellen.  
Type: String  
Erforderlich: Nein

 ** [VersionDescription](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-VersionDescription"></a>
Eine Beschreibung für die erste Version des Dashboards, die gerade erstellt wird.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge von 512.  
Erforderlich: Nein

## Antwortsyntax
<a name="API_UpdateDashboard_ResponseSyntax"></a>

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

{
   "Arn": "string",
   "CreationStatus": "string",
   "DashboardId": "string",
   "RequestId": "string",
   "Status": number,
   "VersionArn": "string"
}
```

## Antwortelemente
<a name="API_UpdateDashboard_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

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

 ** [Arn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) der Ressource.  
Type: String

 ** [CreationStatus](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-CreationStatus"></a>
Der Erstellungsstatus der Anfrage.  
Type: String  
Zulässige Werte:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [DashboardId](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-DashboardId"></a>
Die ID für das Dashboard.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+` 

 ** [RequestId](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-RequestId"></a>
DieAWSAnforderungs-ID für diese Operation.  
Type: String

 ** [Status](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Status"></a>
Der HTTP-Status der Anforderung.  
Type: Ganzzahl

 ** [VersionArn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-VersionArn"></a>
Der ARN des Dashboards, einschließlich der Versionsnummer.  
Type: String

## Fehler
<a name="API_UpdateDashboard_Errors"></a>

Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unter[Häufige Fehler](CommonErrors.md).

 ** ConflictException **   
Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen.  
HTTStatus Code: 409

 ** InternalFailureException **   
Es ist ein interner Fehler aufgetreten.  
HTTStatus Code: 500

 ** InvalidParameterValueException **   
Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist.  
HTTStatus Code: 400

 ** LimitExceededException **   
Ein Limit wurde überschritten.  
HTTStatus Code: 409

 ** ResourceNotFoundException **   
Mindestens eine Ressource kann nicht gefunden werden.  
HTTStatus Code: 404

 ** ThrottlingException **   
Der Zugriff wird gedrosselt  
HTTStatus 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 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.  
HTTStatus Code: 403

## Weitere Informationen finden Sie unter:
<a name="API_UpdateDashboard_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateDashboard) 
+  [AWSSDK-Status JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateDashboard)