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

UpdateTemplate

Aggiorna un modello da Amazon esistente QuickSight analisi o altro modello.

Sintassi della richiesta

PUT /accounts/AwsAccountId/templates/TemplateId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "SourceEntity": { 
      "SourceAnalysis": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      },
      "SourceTemplate": { 
         "Arn": "string"
      }
   },
   "VersionDescription": "string"
}

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

L'ID delAWSaccount che contiene il modello che stai aggiornando.

Vincoli di lunghezza: Lunghezza fissa di 12.

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

Campo obbligatorio in Sì

TemplateId

L'ID per il modello.

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

Modello: [\w\-]+

Campo obbligatorio in Sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

SourceEntity

L'entità che si utilizza come origine quando si aggiorna il modello. Nello statoSourceEntity, si specifica il tipo di oggetto che si sta utilizzando come origine:SourceTemplateper un modello oSourceAnalysisper un'analisi in. Entrambi richiedono un Amazon Resource Name (ARN). PerSourceTemplate, specificare l'ARN del modello sorgente. PerSourceAnalysis, specificare l'ARN dell'analisi dell'origine. LaSourceTemplateL'ARN può contenere qualsiasiAWSaccount e qualsiasi Amazon QuickSight-supportatoRegione AWS;.

Utilizzo dell'DataSetReferencesentità all'internoSourceTemplateoSourceAnalysisper elencare i set di dati sostitutivi per i segnaposto elencati nell'originale. Lo schema in ogni set di dati deve corrispondere al relativo segnaposto.

Tipo: TemplateSourceEntity oggetto

Campo obbligatorio in Sì

Name

Il nome per il modello.

Type: Stringa

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

Campo obbligatorio in No

VersionDescription

Una descrizione dell'attuale versione del modello che viene aggiornata. Ogni volta che chiamiUpdateTemplate, si crea una nuova versione del modello. Ciascuna versione del modello conserva una descrizione della versione nellaVersionDescription.

Type: Stringa

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

Campo obbligatorio in No

Sintassi della risposta

HTTP/1.1 Status
Content-type: application/json

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

Type: Stringa

CreationStatus

Lo stato della creazione del modello.

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

TemplateId

L'ID per il modello.

Type: Stringa

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

Modello: [\w\-]+

VersionArn

L'ARN per il modello, comprese le informazioni sulla versione della prima versione.

Type: Stringa

Errori

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

ConflictException

L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.

Codice di stato HTTP: 409

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 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: