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à.

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

Aggiorna un pannello di controllo in unAWSconto.

**Nota**  
L'aggiornamento di un dashboard crea una nuova versione del dashboard ma non pubblica immediatamente la nuova versione. È possibile aggiornare la versione pubblicata di un pannello di controllo utilizzando il` [UpdateDashboardPublishedVersion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPublishedVersion.html) `Operazione API.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_UpdateDashboard_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-AwsAccountId"></a>
L'ID delAWSaccount che contiene la dashboard che stai aggiornando.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [DashboardId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardId"></a>
L'ID del pannello di controllo.  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+`   
Campo obbligatorio: Sì

## Corpo della richiesta
<a name="API_UpdateDashboard_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Name](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Name"></a>
Il nome visualizzato del pannello di controllo.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: Sì

 ** [SourceEntity](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-SourceEntity"></a>
L'entità che si utilizza come origine quando si aggiorna il dashboard. Nello stato`SourceEntity`, si specifica il tipo di oggetto che si sta utilizzando come origine. Puoi aggiornare una dashboard solo da un modello, quindi utilizzi un`SourceTemplate`Entità. Se è necessario aggiornare un dashboard da un'analisi, convertire innanzitutto l'analisi in un modello utilizzando il` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `Operazione API. Per`SourceTemplate`, specifica l'Amazon Resource Name (ARN) del modello di origine. La`SourceTemplate`L'ARN può contenere qualsiasiAWSaccount e qualsiasi Amazon QuickSight-supportatoRegione AWS.   
Utilizzo dell'`DataSetReferences`entità all'interno`SourceTemplate`per elencare i set di dati sostitutivi per i segnaposto elencati nell'originale. Lo schema in ogni set di dati deve corrispondere al relativo segnaposto.   
Tipo: [DashboardSourceEntity](API_DashboardSourceEntity.md) oggetto  
Campo obbligatorio: Sì

 ** [DashboardPublishOptions](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardPublishOptions"></a>
Opzioni per la pubblicazione della dashboard quando la si crea:  
+  `AvailabilityStatus`per`AdHocFilteringOption`- questo stato può essere`ENABLED`o`DISABLED`. Quando questo è impostato su`DISABLED`, Amazon QuickSight disabilita il riquadro dei filtri sinistro sulla dashboard pubblicata, che può essere utilizzato per il filtraggio ad hoc (una tantum). Questa opzione è`ENABLED`per impostazione predefinita. 
+  `AvailabilityStatus`per`ExportToCSVOption`- questo stato può essere`ENABLED`o`DISABLED`. L'opzione visiva per esportare i dati nel formato .CSV non è abilitata quando è impostata su`DISABLED`. Questa opzione è`ENABLED`per impostazione predefinita. 
+  `VisibilityState`per`SheetControlsOption`- Questo stato di visibilità può essere`COLLAPSED`o`EXPANDED`. Questa opzione è`COLLAPSED`per impostazione predefinita. 
Tipo: [DashboardPublishOptions](API_DashboardPublishOptions.md) oggetto  
Campo obbligatorio: No

 ** [Parameters](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Parameters"></a>
Una struttura che contiene i parametri del cruscotto. Si tratta di sostituzioni dei parametri per una dashboard. Una dashboard può avere qualsiasi tipo di parametro e alcuni parametri possono accettare più valori.  
Tipo: [Parameters](API_Parameters.md) oggetto  
Campo obbligatorio: No

 ** [ThemeArn](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-ThemeArn"></a>
L'Amazon Resource Name (ARN) del tema utilizzato per questo pannello di controllo. Se si aggiunge un valore per questo campo, il valore originariamente associato all'Entità sostituisce il valore originariamente associato all'Entità. Il tema ARN deve esistere nello stessoAWSaccount in cui si crea la dashboard.  
Type: Stringa  
Campo obbligatorio: No

 ** [VersionDescription](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-VersionDescription"></a>
Una descrizione per la prima versione del pannello di controllo in fase di creazione.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 512 caratteri.  
Campo obbligatorio: No

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_UpdateDashboard_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Arn"></a>
Il nome della risorsa Amazon (ARN) della risorsa .  
Type: Stringa

 ** [CreationStatus](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-CreationStatus"></a>
Lo stato della creazione della richiesta.  
Type: Stringa  
Valori validi: ` 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>
L'ID del pannello di controllo.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+` 

 ** [RequestId](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-RequestId"></a>
LaAWSID della richiesta per questa operazione.  
Type: Stringa

 ** [Status](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Status"></a>
Lo stato HTTP della richiesta.  
Type: Numero intero

 ** [VersionArn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-VersionArn"></a>
L'ARN del dashboard, incluso il numero di versione.  
Type: Stringa

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** 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

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
Uno o più risorse non sono state trovate.  
Codice di stato HTTP: 404

 ** ThrottlingException **   
L'accesso è limitato.  
Codice di stato HTTP: 429

 ** UnsupportedUserEditionException **   
Questo errore indica che si sta chiamando un'operazione su Amazon QuickSightabbonamento in cui l'edizione non include il supporto per tale operazione. Amazon Amazon QuickSight attualmente ha Standard Edition ed Enterprise Edition. Non tutte le operazioni e funzionalità sono disponibili in ogni edizione.  
Codice di stato HTTP: 403

## Vedi anche
<a name="API_UpdateDashboard_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateDashboard) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateDashboard) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateDashboard) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateDashboard) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateDashboard) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateDashboard)