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

DescribeAccountCustomization

Descrive le personalizzazioni associate alAWSaccount e Amazon Amazon QuickSight spazio dei nomi inRegione AWS. Amazon QuickSight console valuta quali personalizzazioni applicare eseguendo questa operazione API conResolvedFlag incluso.

Per determinare quali personalizzazioni vengono visualizzate quando si esegue questo comando, può essere utile visualizzare la relazione delle entità coinvolte.

  • AWS account- IlAWSaccount esiste nella parte superiore della gerarchia. Ha il potenziale per utilizzare tutti iRegioni AWSeAWSServizi. Quando ti abboni ad Amazon QuickSight, ne scegli unoRegione AWSda utilizzare come regione di origine. È qui che si trova la tua capacità SPICE gratuita. Puoi usare Amazon QuickSight in qualsiasiRegione AWS.

  • Regione AWS - In eachRegione AWSdove accedi ad Amazon QuickSightalmeno una volta, Amazon QuickSight funge da istanza separata dello stesso servizio. Se hai una directory utenti, questa risiede in us-east-1, che è gli Stati Uniti orientali (Virginia settentrionale). In generale, questi utenti hanno accesso ad Amazon QuickSight inRegione AWS, a meno che non siano vincolati a uno spazio dei nomi.

    Per eseguire il comando in unRegione AWS, si modificano le impostazioni della regione. Se usiAWS CLI, puoi utilizzare una delle seguenti opzioni:

  • Namespace- A QuickSight namespace è una partizione che contiene utenti e risorse (origini dati, set di dati, dashboard e così via). Per accedere alle risorse che si trovano in uno spazio dei nomi specifico, anche gli utenti e i gruppi devono far parte dello stesso spazio dei nomi. Le persone che condividono uno spazio dei nomi sono completamente isolate dagli utenti e dalle risorse in altri spazi dei nomi, anche se si trovano nello stessoAWSaccount eRegione AWS.

  • Applied customizations- All'interno diRegione AWS, un set di Amazon QuickSight le personalizzazioni possono essere applicate aAWSaccount o in uno spazio dei nomi. Le impostazioni applicate a uno spazio dei nomi sostituiscono le impostazioni applicate a unAWSconto. Tutte le impostazioni sono isolate in un unicoRegione AWS. Per applicarli in altriRegioni AWS, eseguireCreateAccountCustomizationcomando in ciascunoRegione AWSdove desideri applicare le stesse personalizzazioni.

Sintassi della richiesta

GET /accounts/AwsAccountId/customizations?namespace=Namespace&resolved=Resolved HTTP/1.1

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

L'ID deiAWSaccount che desideri descrivere Amazon QuickSight personalizzazioni per.

Vincoli di lunghezza: Lunghezza fissa di 12.

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

Campo obbligatorio: Sì

Namespace

Amazon QuickSight spazio dei nomi che desideri descrivere Amazon QuickSight personalizzazioni per.

Vincoli di lunghezza: La lunghezza massima è 64 caratteri.

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

Resolved

LaResolvedflag funziona con gli altri parametri per determinare quale vista di Amazon QuickSight le personalizzazioni vengono restituite. Puoi aggiungere questo flag al tuo comando per utilizzare la stessa vista di Amazon QuickSight utilizza per identificare le personalizzazioni da applicare alla console. Ometti questo flag o impostalo suno-resolved, per rivelare le personalizzazioni configurate a diversi livelli.

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 Status
Content-type: application/json

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

AccountCustomization

Amazon QuickSight personalizzazioni esistenti nell'attualeRegione AWS.

Tipo: AccountCustomization oggetto

Arn

Amazon Resource Name (ARN) della personalizzazione associataAWSconto.

Type: Stringa

AwsAccountId

L'ID deiAWSaccount che stai descrivendo.

Type: Stringa

Vincoli di lunghezza: Lunghezza fissa di 12.

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

Namespace

Amazon QuickSight namespace che stai descrivendo.

Type: Stringa

Vincoli di lunghezza: La lunghezza massima è 64 caratteri.

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

RequestId

LaAWSID richiesta per questa operazione.

Type: Stringa

Errori

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

AccessDeniedException

Non hai l'accesso. 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

ResourceNotFoundException

Uno o più risorse non sono state trovate.

Codice di stato HTTP: 404

ResourceUnavailableException

Questa risorsa al momento non è disponibile.

Codice di stato HTTP: 503

ThrottlingException

L'accesso è limitato.

Codice di stato HTTP: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: