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

CreateAccountSubscription

Erstellt ein Amazon QuickSight Konto oder abonniert Amazon QuickSight Q.

DieAWS-Regiondenn das Konto wird von dem abgeleitet, was in derAWS CLIoder SDK-Updates. Dieser Vorgang wird in der Region USA Ost (Ohio), Südamerika (Sao Paulo) oder Asien-Pazifik (Singapur) nicht unterstützt.

Bevor Sie diesen Vorgang verwenden, stellen Sie sicher, dass Sie eine Verbindung zu einem vorhandenenAWS-Konto. Wenn dies nicht der Fall istAWS-Kontofinden Sie unterRegistrieren beiAWSimAmazon QuickSight Benutzerhandbuch. Die Person, die sich bei Amazon anmeldet QuickSight muss das Richtige habenAWS Identity and Access Management(IAM) Berechtigungen. Weitere Informationen finden Sie unterBeispiele für IAM-Richtlinien für Amazon QuickSightimAmazon QuickSight Benutzerhandbuch.

Wenn Ihre IAM-Richtlinie beides umfasst,SubscribeundCreateAccountSubscriptionAktionen, stellen Sie sicher, dass beide Aktionen aufAllow. Wenn eine der Aktionen aufDeny, derDenyDie Aktion hat Vorrang und Ihr API-Aufruf schlägt fehl.

Sie können eine vorhandene IAM-Rolle nicht übergeben, um auf andere zuzugreifenAWSDienste, die diese API-Operation verwenden. So übergeben Sie Ihre bestehende IAM-Rolle an Amazon QuickSightfinden Sie unterÜbergeben von IAM-Rollen an Amazon QuickSightimAmazon QuickSight Benutzerhandbuch.

Sie können den standardmäßigen Ressourcenzugriff für das neue Konto nicht von Amazon aus festlegen QuickSightAPI. Fügen Sie stattdessen den standardmäßigen Ressourcenzugriff von Amazon hinzu QuickSight console. Weitere Informationen zum Einstellen des standardmäßigen Ressourcenzugriffs aufAWSDienstleistungen, sieheStandardzugriff auf Ressourcen festlegen aufAWSDienstleistungenimAmazon QuickSightBenutzerhandbuch.

Anforderungssyntax

POST /account/AwsAccountId HTTP/1.1
Content-type: application/json

{
   "AccountName": "string",
   "ActiveDirectoryName": "string",
   "AdminGroup": [ "string" ],
   "AuthenticationMethod": "string",
   "AuthorGroup": [ "string" ],
   "ContactNumber": "string",
   "DirectoryId": "string",
   "Edition": "string",
   "EmailAddress": "string",
   "FirstName": "string",
   "LastName": "string",
   "NotificationEmail": "string",
   "ReaderGroup": [ "string" ],
   "Realm": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AwsAccountId

DieAWS-KontoID des Kontos, das Sie zum Erstellen Ihres Amazon-Kontos verwenden QuickSight Konto.

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

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

Erforderlich. Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AccountName

Der Name Ihres Amazon QuickSight Konto. Dieser Name ist einzigartig in allenAWS, und es wird nur angezeigt, wenn sich Benutzer anmelden. Diese können Sie nicht ändernAccountNameWert nach dem Amazonas QuickSight Konto wurde erstellt.

Type: String

Erforderlich. Ja

AuthenticationMethod

Die Methode, die nutzen soll, um Ihr Amazon-Konto zu authentifizieren QuickSight Konto. Derzeit lauten die gültigen Werte für diesen ParameterIAM_AND_QUICKSIGHT,IAM_ONLY, undACTIVE_DIRECTORY.

Wenn Sie angeben,ACTIVE_DIRECTORY, stellen Sie eineActiveDirectoryNameund einAdminGroupmit Active Directory.

Type: String

Zulässige Werte: IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY

Erforderlich. Ja

Edition

Die Ausgabe von Amazon QuickSight die Ihr Konto haben soll. Derzeit können Sie auswählen ausENTERPRISEoderENTERPRISE_AND_Q.

Wenn Sie angeben,ENTERPRISE_AND_Qsind die folgenden Parameter erforderlich:

  • FirstName

  • LastName

  • EmailAddress

  • ContactNumber

Type: String

Zulässige Werte: STANDARD | ENTERPRISE | ENTERPRISE_AND_Q

Erforderlich. Ja

NotificationEmail

Die E-Mail-Adresse, die Sie möchten Amazon QuickSight um Benachrichtigungen bezüglich Ihres Amazon-Kontos zu senden QuickSight Konto oder Amazon QuickSight Abonnement.

Type: String

Erforderlich. Ja

ActiveDirectoryName

Der Name Ihres Active Directory. Dies ist ein Pflichtfeld, wennACTIVE_DIRECTORYist die gewählte Authentifizierungsmethode des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

AdminGroup

Die mit Ihrem Active Directory verknüpfte Admin-Gruppe. Dies ist ein Pflichtfeld, wennACTIVE_DIRECTORYist die gewählte Authentifizierungsmethode des neuen Amazon QuickSight Konto. Weitere Informationen zur Verwendung von Active Directory in Amazon QuickSightfinden Sie unterVerwenden von Active Directory mit Amazon QuickSight Enterprise Editionim Amazon QuickSight-Benutzerhandbuch.

Type: Zeichenfolgen-Array

Erforderlich. Nein

AuthorGroup

Die Autorengruppe, die mit Ihrem Active Directory verknüpft ist. Weitere Informationen zur Verwendung von Active Directory in Amazon QuickSightfinden Sie unterVerwenden von Active Directory mit Amazon QuickSight Enterprise Editionim Amazon QuickSight-Benutzerhandbuch.

Type: Zeichenfolgen-Array

Erforderlich. Nein

ContactNumber

Eine 10-stellige Telefonnummer für den Autor des Amazon-Autors QuickSight Konto, das für future Kommunikation verwendet werden kann. Dies ist ein Pflichtfeld, wennENTERPPRISE_AND_Qist die ausgewählte Ausgabe des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

DirectoryId

Die ID des Active Directory, das Ihrem Amazon-Konto zugeordnet ist. QuickSight Konto.

Type: String

Erforderlich. Nein

EmailAddress

Die E-Mail-Adresse des Autors von Amazon QuickSight Konto, das für future Kommunikation verwendet werden kann. Dies ist ein Pflichtfeld, wennENTERPPRISE_AND_Qist die ausgewählte Ausgabe des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

FirstName

Der Vorname des Autors des Amazon-Autors QuickSight Konto, das für future Kommunikation verwendet werden kann. Dies ist ein Pflichtfeld, wennENTERPPRISE_AND_Qist die ausgewählte Ausgabe des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

LastName

Der Nachname des Autors des Amazon-Autors QuickSight Konto, das für future Kommunikation verwendet werden kann. Dies ist ein Pflichtfeld, wennENTERPPRISE_AND_Qist die ausgewählte Ausgabe des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

ReaderGroup

Die Lesergruppe, die mit Ihrem Active Directory verknüpft ist. Weitere Informationen zur Verwendung von Active Directory in Amazon QuickSightfinden Sie unterVerwenden von Active Directory mit Amazon QuickSight Enterprise EditionimAmazon QuickSightBenutzerhandbuch.

Type: Zeichenfolgen-Array

Erforderlich. Nein

Realm

Der Bereich des Active Directory, der mit Ihrem Amazon verknüpft ist QuickSight Konto. Dies ist ein Pflichtfeld, wennACTIVE_DIRECTORYist die gewählte Authentifizierungsmethode des neuen Amazon QuickSight Konto.

Type: String

Erforderlich. Nein

Antwortsyntax

HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string",
   "SignupResponse": { 
      "accountName": "string",
      "directoryType": "string",
      "IAMUser": boolean,
      "userLoginName": "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.

RequestId

DieAWSAnforderungs-ID für diese Operation.

Type: String

SignupResponse

EINSignupResponseObjekt, das Informationen über ein neu erstelltes Amazon zurückgibt QuickSight Konto.

Typ: SignupResponse Objekt

Fehler

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

AccessDeniedException

Sie haben keinen Zugriff auf diesen Artikel. 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 , 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

PreconditionNotMetException

Mindestens eine Vorbedingung ist nicht erfüllt.

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: