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

CreateTheme

Erstellt ein Design.

Ein Design besteht aus Konfigurationsoptionen für Farbe und Layout. Designs werden für Analysen und Dashboards angewendet. Weitere Informationen finden Sie unterVerwenden von Designs in Amazon QuickSightimAmazon QuickSight Benutzerhandbuch.

Anforderungssyntax

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"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AwsAccountId

Die ID derAWSKonto, in dem das neue Design gespeichert werden soll.

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

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

Erforderlich: Ja

ThemeId

Eine ID für das Theme, das Sie erstellen möchten. Die Theme-ID ist eindeutig proAWS-Regionin jedemAWSKonto.

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

Pattern: [\w\-]+

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

BaseThemeId

Die ID des Designs, das von einem benutzerdefinierten Design geerbt wird. Alle Themen erben von einem der von Amazon definierten Startthemen QuickSight. Eine Liste der Startthemen finden Sie unterListThemesoder wähleThemes (Designs)aus einer -Analyse.

Type: String

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

Pattern: [\w\-]+

Erforderlich: Ja

Configuration

Die Designkonfiguration, die die Design-Anzeigeeigenschaften enthält.

Typ: ThemeConfiguration Objekt

Erforderlich: Ja

Name

Ein Anzeigename für das Thema.

Type: String

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

Erforderlich: Ja

Permissions

Eine gültige Gruppierung von Ressourcenberechtigungen, die auf das neue Design angewendet werden sollen.

Type: Array-vonResourcePermissionObjekte

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Erforderlich: Nein

Tags

Eine Zuordnung der Schlüssel-Wert-Paare für die Ressourcen-Tags, die Sie der Ressource hinzufügen möchten.

Type: Array-vonTagObjekte

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Erforderlich: Nein

VersionDescription

Eine Beschreibung der ersten Version des Themes, das Sie erstellen. Jedes MalUpdateThemewird aufgerufen, eine neue Version wird erstellt. Jede Version des Themes hat eine Beschreibung der Version in derVersionDescriptionfield.

Type: String

Längenbeschränkungen: Mindestlänge 1. Maximale Länge von 512.

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string",
   "ThemeId": "string",
   "VersionArn": "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.

Arn

Der Amazon-Ressourcenname (ARN) für das Design.

Type: String

CreationStatus

Der Status der Themenerstellung.

Type: String

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

RequestId

DieAWSAnforderungs-ID für diese Operation.

Type: String

ThemeId

Die ID des Designs.

Type: String

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

Pattern: [\w\-]+

VersionArn

Der Amazon-Ressourcenname (ARN) für das neue Design.

Type: String

Fehler

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

AccessDeniedException

Sie haben keinen Zugriff auf diese Komponente. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight -Service, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.

HTTP Status Code: 401

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

LimitExceededException

Ein Limit wurde überschritten.

HTTP Status Code: 409

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: