CreateTheme - Amazon QuickSight
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

CreateTheme

Crea un tema.

Un tema è un insieme di opzioni di configurazione per il colore e il layout. I temi si applicano alle analisi e ai dashboard. Per ulteriori informazioni, consultaUtilizzo dei temi in Amazon QuickSightnellaAmazon QuickSight Guida per l’utente di.

Sintassi della richiesta

POST /accounts/AwsAccountId/themes/ThemeId HTTP/1.1
Content-type: application/json

{
   "BaseThemeId": "string",
   "Configuration": { 
      "DataColorPalette": { 
         "Colors": [ "string" ],
         "EmptyFillColor": "string",
         "MinMaxGradient": [ "string" ]
      },
      "Sheet": { 
         "Tile": { 
            "Border": { 
               "Show": boolean
            }
         },
         "TileLayout": { 
            "Gutter": { 
               "Show": boolean
            },
            "Margin": { 
               "Show": boolean
            }
         }
      },
      "UIColorPalette": { 
         "Accent": "string",
         "AccentForeground": "string",
         "Danger": "string",
         "DangerForeground": "string",
         "Dimension": "string",
         "DimensionForeground": "string",
         "Measure": "string",
         "MeasureForeground": "string",
         "PrimaryBackground": "string",
         "PrimaryForeground": "string",
         "SecondaryBackground": "string",
         "SecondaryForeground": "string",
         "Success": "string",
         "SuccessForeground": "string",
         "Warning": "string",
         "WarningForeground": "string"
      }
   },
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VersionDescription": "string"
}

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

L'ID delAWSaccount in cui memorizzare il nuovo tema.

Vincoli di lunghezza Lunghezza fissa di 12.

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

Obbligatorio Sì

ThemeId

Un ID per il tema che desideri creare. L'ID del tema è univoco perRegione AWSin ogniAWSconto.

Vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.

Modello: [\w\-]+

Obbligatorio Sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

BaseThemeId

L'ID del tema da cui un tema eredita le proprietà. Tutti i temi ereditano da uno dei temi iniziali definiti da Amazon QuickSight. Per un elenco dei temi iniziali, utilizzareListThemesoppure scegliThemes (Temi)dall'interno di un'analisi in.

Type: Stringa

Vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.

Modello: [\w\-]+

Obbligatorio Sì

Configuration

La configurazione del tema, che contiene le proprietà di visualizzazione del tema.

Tipo: ThemeConfiguration oggetto

Obbligatorio Sì

Name

Un nome visualizzato per il tema.

Type: Stringa

Vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.

Obbligatorio Sì

Permissions

Un raggruppamento valido di autorizzazioni per le risorse da applicare al nuovo tema.

Type: Matrice diResourcePermissionoggetti

Membri dell'array Numero minimo di 1 elemento. Numero massimo di 64 elementi.

Obbligatorio No

Tags

Una mappa delle coppie chiave-valore per il tag o i tag della risorsa che si desidera aggiungere alla risorsa.

Type: Matrice diTagoggetti

Membri dell'array Numero minimo di 1 elemento. Numero massimo di 200 elementi.

Obbligatorio No

VersionDescription

Una descrizione della prima versione del tema che stai creando. Ogni voltaUpdateTheme, viene creata una nuova versione. Ogni versione del tema ha una descrizione della versione nellaVersionDescription.

Type: Stringa

Vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 512 caratteri.

Obbligatorio No

Sintassi della risposta

HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string",
   "ThemeId": "string",
   "VersionArn": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

Status

Lo stato HTTP della richiesta.

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

Arn

L'Amazon Resource Name (ARN) per il tema.

Type: Stringa

CreationStatus

Lo stato di creazione del tema.

Type: Stringa

Valori validi: CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

RequestId

LaAWSID della richiesta per questa operazione.

Type: Stringa

ThemeId

L'ID del tema.

Type: Stringa

Vincoli di lunghezza Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.

Modello: [\w\-]+

VersionArn

L'Amazon Resource Name (ARN) per il nuovo tema.

Type: Stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

Non hai l'accesso a questo elemento. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.

Codice di stato HTTP 401

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

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 Amazon Amazon QuickSight al momento 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: