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à. # CreateDashboard Crea un dashboard da un modello. Per creare un nuovo modello, vedere l'operazione API ` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `. Una dashboard è un'entità in Amazon QuickSight che identifica Amazon QuickSight report, creati dalle analisi. Puoi condividere Amazon QuickSight pannelli di controllo. Se si dispone delle autorizzazioni corrette, è possibile creare report e-mail pianificati a partire da essi. Se si dispone delle autorizzazioni corrette, è possibile creare un dashboard da un modello esistente in unAWSconto. ## Sintassi della richiesta ``` POST /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" ] } ] }, "Permissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "SourceEntity": { "SourceTemplate": { "Arn": "string", "DataSetReferences": [ { "DataSetArn": "string", "DataSetPlaceholder": "string" } ] } }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThemeArn": "string", "VersionDescription": "string" } ``` ## Parametri della richiesta URI: La richiesta utilizza i seguenti parametri URI. ** [AwsAccountId](#API_CreateDashboard_RequestSyntax) ** L'ID delAWSaccount in cui desideri creare il pannello di controllo. Vincoli di lunghezza: Lunghezza fissa di 12. Modello: `^[0-9]{12}$` Campo obbligatorio: Sì ** [DashboardId](#API_CreateDashboard_RequestSyntax) ** L'ID del dashboard, anch'esso aggiunto alla policy IAM. Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri. Modello: `[\w\-]+` Campo obbligatorio: Sì ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Name](#API_CreateDashboard_RequestSyntax) ** Il nome visualizzato del dashboard. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri. Campo obbligatorio: Sì ** [SourceEntity](#API_CreateDashboard_RequestSyntax) ** L'entità che stai utilizzando come origine quando crei il pannello di controllo. Nello stato`SourceEntity`, si specifica il tipo di oggetto che si sta utilizzando come origine. È possibile creare un pannello di controllo solo da un modello, quindi si utilizza un`SourceTemplate`Entità. Se è necessario creare 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. 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_CreateDashboard_RequestSyntax) ** Opzioni per la pubblicazione della dashboard quando la si crea: + `AvailabilityStatus`per`AdHocFilteringOption`- questo stato può essere`ENABLED`o`DISABLED`. Quando questo è impostato`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 default. + `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 default. + `VisibilityState`per`SheetControlsOption`- Questo stato di visibilità può essere`COLLAPSED`o`EXPANDED`. Questa opzione è`COLLAPSED`per default. Tipo: [DashboardPublishOptions](API_DashboardPublishOptions.md) oggetto Campo obbligatorio: No ** [Parameters](#API_CreateDashboard_RequestSyntax) ** I parametri per la creazione della dashboard, che si desidera utilizzare per sovrascrivere le impostazioni predefinite. Una dashboard può avere qualsiasi tipo di parametro e alcuni parametri possono accettare più valori. Tipo: [Parameters](API_Parameters.md) oggetto Campo obbligatorio: No ** [Permissions](#API_CreateDashboard_RequestSyntax) ** Una struttura contenente le autorizzazioni del dashboard. È possibile utilizzare questa struttura per concedere le autorizzazioni fornendo un elenco di informazioni sulle azioni IAM per ogni ARN principale. Per non specificare alcuna autorizzazione, omettere l'elenco delle autorizzazioni. Type: Matrice di[ResourcePermission](API_ResourcePermission.md)oggetti Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi. Campo obbligatorio: No ** [Tags](#API_CreateDashboard_RequestSyntax) ** Contiene una mappa delle coppie chiave-valore per il tag o i tag di risorsa assegnati alla dashboard. Type: Matrice di[Tag](API_Tag.md)oggetti Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 200 elementi. Campo obbligatorio: No ** [ThemeArn](#API_CreateDashboard_RequestSyntax) ** Amazon Resource Name (ARN) del tema utilizzato per questo dashboard. Se si aggiunge un valore per questo campo, il valore specificato sostituisce il valore utilizzato nell'entità di origine. Il tema ARN deve esistere nello stessoAWSaccount in cui si crea la dashboard. Type: Stringa Campo obbligatorio: No ** [VersionDescription](#API_CreateDashboard_RequestSyntax) ** Una descrizione per la prima versione del dashboard 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 ``` HTTP/1.1 Status Content-type: application/json { "Arn": "string", "CreationStatus": "string", "DashboardId": "string", "RequestId": "string", "VersionArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP. ** [Status](#API_CreateDashboard_ResponseSyntax) ** Lo stato HTTP della richiesta. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [Arn](#API_CreateDashboard_ResponseSyntax) ** L'ARN del dashboard. Type: Stringa ** [CreationStatus](#API_CreateDashboard_ResponseSyntax) ** Stato della richiesta di creazione del dashboard. Type: Stringa Valori validi: ` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` ** [DashboardId](#API_CreateDashboard_ResponseSyntax) ** L'ID del dashboard. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri. Modello: `[\w\-]+` ** [RequestId](#API_CreateDashboard_ResponseSyntax) ** LaAWSID della richiesta per questa operazione. Type: Stringa ** [VersionArn](#API_CreateDashboard_ResponseSyntax) ** L'ARN della dashboard, incluso il numero di versione della prima versione creata. Type: Stringa ## Errori 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 ** ResourceExistsException ** La risorsa specificata esiste già. 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 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 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/CreateDashboard) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateDashboard) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateDashboard) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateDashboard) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateDashboard) + [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateDashboard) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateDashboard) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateDashboard) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateDashboard)