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

CreateAccountCustomization

Erstellt Amazon QuickSight Anpassungen für den aktuellenAWS-Region. Derzeit können Sie ein benutzerdefiniertes Standarddesign hinzufügen, indem Sie dieCreateAccountCustomizationoderUpdateAccountCustomizationAPI-Operation. So passen Sie Amazon weiter an QuickSight indem Sie Amazon entfernen QuickSightBeispiele für Assets und Videos für alle neuen Benutzer finden Sie unterAmazon anpassen QuickSightimAmazon QuickSight -Benutzerhandbuch.

Sie können Anpassungen für IhreAWSoder, wenn Sie einen Namespace angeben, für ein QuickSight Namespace stattdessen. Anpassungen, die für einen Namespace gelten, überschreiben immer Anpassungen, die für einenAWSKonto. Um herauszufinden, welche Anpassungen zutreffen, verwenden Sie dieDescribeAccountCustomizationAPI-Operation.

Bevor Sie dasCreateAccountCustomizationAPI-Operation Um ein Thema als Namespace-Standard hinzuzufügen, stellen Sie sicher, dass Sie das Thema zuerst mit dem Namespace teilen. Wenn Sie es nicht mit dem Namespace teilen, ist das Design für Ihre Benutzer nicht sichtbar, selbst wenn Sie es als Standarddesign festlegen. Um zu überprüfen, ob das Design freigegeben ist, zeigen Sie die aktuellen Berechtigungen an, indem Sie die DescribeThemePermissions API-Operation. Um das Thema zu teilen, gewähren Sie Berechtigungen, indem Sie das UpdateThemePermissions API-Operation.

Anforderungssyntax

POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AwsAccountId

Die ID desAWS-Konto, das Sie an Amazon anpassen möchten. QuickSight für.

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

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

Erforderlich: Ja

Namespace

Der Amazon QuickSight Namespace, dem Sie Anpassungen hinzufügen möchten.

Längenbeschränkungen: Höchstlänge = 64 Zeichen.

Pattern: ^[a-zA-Z0-9._-]*$

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AccountCustomization

Der Amazon QuickSight Anpassungen, die Sie in der aktuellen Version hinzufügenAWS-Region. Sie können diese zu einemAWSKonto und ein QuickSight Namespace.

Sie können beispielsweise ein Standarddesign hinzufügen, indem SieAccountCustomizationzum Mitternachtsthema: "AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. Sie können auch ein benutzerdefiniertes Thema hinzufügen, indem Sie Folgendes angeben:"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.

Typ: AccountCustomization Objekt

Erforderlich: Ja

Tags

Eine Liste der Tags, die an diese Ressource angefügt werden sollen.

Type: Array vonTagObjekte

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

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 Status
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Arn": "string",
   "AwsAccountId": "string",
   "Namespace": "string",
   "RequestId": "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.

AccountCustomization

Der Amazon QuickSight Anpassungen, die Sie in der aktuellen Version hinzufügenAWS-Region.

Typ: AccountCustomization Objekt

Arn

Der Amazon-Ressourcenname (ARN) für die Anpassung, die Sie dafür erstellt habenAWSKonto.

Type: String

AwsAccountId

Die ID desAWS-Konto, das Sie an Amazon anpassen möchten. QuickSight für.

Type: String

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

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

Namespace

Der Namespace, der der Anpassung zugeordnet ist, die Sie gerade erstellen.

Type: String

Längenbeschränkungen: Höchstlänge = 64 Zeichen.

Pattern: ^[a-zA-Z0-9._-]*$

RequestId

DieAWS-ID für diese Operation.

Type: String

Fehler

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

AccessDeniedException

Sie haben keinen Zugriff auf dieses Element. 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 -Statuscode, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.

HTTP Status Code: 401

ConflictException

Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen.

HTTP Status Code: 409

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

ResourceExistsException

Die angegebene Ressource ist bereits vorhanden.

HTTP Status Code: 409

ResourceNotFoundException

Mindestens eine Ressource kann nicht gefunden werden.

HTTP Status Code: 404

ResourceUnavailableException

Die Ressource ist derzeit nicht verfügbar.

HTTP Status Code: 503

ThrottlingException

Der Zugriff wird gedrosselt

HTTP Status Code: 429

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: