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à. # Lavora con argomenti Quick Sight utilizzando Amazon Quick Sight APIs | | | --- | |  Si applica a: Enterprise Edition  | | | | --- | |    Destinatari: sviluppatori Amazon Quick  | Usa questa sezione per imparare a lavorare con gli argomenti di Quick Sight utilizzando l'interfaccia a riga di comando (CLI) di Amazon Quick Sight. **Prerequisiti** Prima di iniziare, assicurati di avere un ruolo AWS Identity and Access Management (IAM) che conceda all'utente della CLI l'accesso per chiamare le operazioni dell'API Quick Sight. La tabella seguente mostra quali autorizzazioni devono essere aggiunte alla policy IAM per utilizzare operazioni API specifiche. Per utilizzare tutte le operazioni API dell'argomento, aggiungi tutte le autorizzazioni elencate nella tabella. | Operazione API | Policy IAM | | --- | --- | | `CreateTopic` | `quicksight:CreateTopic` `quicksight:PassDataSet` | | `ListTopics` | `quicksight:ListTopics` | | `DescribeTopic` | `quicksight:DescribeTopic` | | `DescribeTopicPermissions` | `quicksight:DescribeTopicPermissions` | | `DescribeTopicRefresh` | `quicksight:DescribeTopicRefresh` | | `DeleteTopic` | `quicksight:DeleteTopic` | | `UpdateTopic` | `quicksight:UpdateTopic` `quicksight:PassDataSet` | | `UpdateTopicPermissions` | `quicksight:UpdateTopicPermissions` | | `CreateTopicRefreshSchedule` | `quicksight:CreateTopicRefreshSchedule` | | `ListTopicRefreshSchedules` | `quicksight:ListTopicRefreshSchedules` | | `DescribeTopicRefreshSchedule` | `quicksight:DescribeTopicRefreshSchedule` | | `UpdateTopicRefreshSchedule` | `quicksight:UpdateTopicRefreshSchedule` | | `DeleteTopicRefreshSchedule` | `quicksight:DeleteTopicRefreshSchedule` | | `BatchCreateTopicReviewedAnswer` | `quicksight:BatchCreateTopicReviewedAnswer` | | `BatchDeleteTopicReviewedAnswer` | `quicksight:BatchDeleteTopicReviewedAnswer` | | `ListTopicReviewedAnswers` | `quicksight:ListTopicReviewedAnswers` | L'esempio seguente mostra una policy IAM che consente a un utente di utilizzare l'operazione API `ListTopics`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "quicksight:ListTopics" ], "Resource": "*" } ] } ``` ------ Dopo aver configurato le autorizzazioni per creare argomenti Quick Sight con Quick Sight APIs, utilizza i seguenti argomenti per creare e utilizzare l'argomento Quick Sight. APIs **Topics** + [Lavora con gli argomenti Quick Sight utilizzando Quick Sight APIs](topic-cli-examples.md) + [Configura le pianificazioni di aggiornamento degli argomenti di Quick Sight con la CLI Quick Sight](topic-refresh-apis.md) + [Copia e migra gli argomenti di Quick Sight all'interno e tra Account AWS](topic-cli-walkthroughs.md) + [Crea e modifica le risposte riviste negli argomenti di Quick Sight con Quick Sight APIs](topic-reviewed-answer-apis.md) # Lavora con gli argomenti Quick Sight utilizzando Quick Sight APIs L'esempio seguente crea un nuovo argomento. ``` aws quicksight create-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID --topic TOPIC ``` È inoltre possibile creare un nuovo argomento utilizzando un file scheletro CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Using [CLI skeleton files nella *Amazon* Quick](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) Sight Developer Guide. ``` aws quicksight create-topic --cli-input-json file://createtopic.json ``` Quando crei un nuovo argomento, la configurazione di aggiornamento del set di dati non viene copiata nell'argomento. Per impostare una pianificazione di aggiornamento per il nuovo argomento, puoi effettuare una chiamata API `create-topic-refresh-schedule`. Per ulteriori informazioni sulla configurazione delle pianificazioni dell'aggiornamento degli argomenti con la CLI, consulta [Configura le pianificazioni di aggiornamento degli argomenti di Quick Sight con la CLI Quick Sight](topic-refresh-apis.md). Dopo aver creato il primo argomento, puoi aggiornare, eliminare, elencare o richiedere un riepilogo di un argomento. L'esempio seguente aggiorna un argomento. ``` aws quicksight update-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID --topic TOPIC ``` È inoltre possibile aggiornare un argomento utilizzando un file scheletro CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Using [CLI skeleton files nella *Amazon* Quick](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) Sight Developer Guide. ``` aws quicksight update-topic --cli-input-json file://updatetopic.json ``` L'esempio seguente fornisce un elenco di tutti gli argomenti in un account Quick. ``` aws quicksight list-topics --aws-account-id AWSACCOUNTID ``` L'esempio seguente elimina un argomento. ``` aws quicksight delete-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` L'esempio seguente fornisce informazioni sulla configurazione di un argomento. ``` aws quicksight describe-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` Il comando seguente aggiorna le autorizzazioni di un argomento. ``` aws quicksight update-topic-permissions --aws-account-id AWSACCOUNTID --topic-id TOPICID --grant-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic --revoke-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic ``` Utilizzate il `grant-permissions` parametro per concedere le autorizzazioni di lettura e autore agli utenti dell'account Quick. Per assegnare le autorizzazioni a un utente dell'account, immetti il seguente valore: `"quicksight:DescribeTopic"`. Per assegnare le autorizzazioni a un utente dell'account, immetti i seguenti valori: + `"quicksight:DescribeTopic"` + `"quicksight:DescribeTopicRefresh"` + `"quicksight:ListTopicRefreshSchedules"` + `"quicksight:DescribeTopicRefreshSchedule"` + `"quicksight:DeleteTopic"` + `"quicksight:UpdateTopic"` + `"quicksight:CreateTopicRefreshSchedule"` + `"quicksight:DeleteTopicRefreshSchedule"` + `"quicksight:UpdateTopicRefreshSchedule"` + `"quicksight:DescribeTopicPermissions"` + `"quicksight:UpdateTopicPermissions"` Il parametro `RevokePermissions` revoca tutte le autorizzazioni concesse a un utente dell'account. Il comando seguente descrive tutte le autorizzazioni di un argomento. ``` aws quicksight describe-topic-permissions --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` Dopo aver creato un argomento Quick Sight, puoi utilizzare Amazon Quick Sight APIs per [configurare una pianificazione di aggiornamento degli argomenti](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [migrare gli argomenti Quick Sight all'interno o tra account](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) e [creare risposte riviste](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis). # Configura le pianificazioni di aggiornamento degli argomenti di Quick Sight con la CLI Quick Sight Il comando seguente crea una pianificazione di aggiornamento di un argomento. ``` aws quicksight create-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-arn DATASETARN --refresh-schedule REFRESHSCHEDULE ``` Dopo aver creato una pianificazione di aggiornamento per un argomento, è possibile aggiornare, eliminare, elencare o richiedere un riepilogo della pianificazione di aggiornamento dell'argomento. Il comando seguente aggiorna la pianificazione di aggiornamento di un argomento. ``` aws quicksight update-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID --refresh-schedule REFRESHSCHEDULE ``` L'esempio seguente fornisce un elenco di tutte le pianificazioni di aggiornamento configurate per un argomento. ``` aws quicksight list-topic-refresh-schedules --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` L'esempio seguente mostra come eliminare una pianificazione di aggiornamento degli argomenti. ``` aws quicksight delete-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID ``` L'esempio seguente fornisce informazioni su come è stata configurata la pianificazione dell'aggiornamento di un argomento. ``` aws quicksight describe-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID ``` # Copia e migra gli argomenti di Quick Sight all'interno e tra Account AWS Puoi migrare gli argomenti di Quick Sight da un account all'altro con l'interfaccia a riga di comando (CLI) di Quick Sight. Invece di replicare manualmente lo stesso argomento su più dashboard, namespace o account, puoi utilizzare la CLI di Quick Sight per riutilizzare lo stesso argomento più volte. Questa funzionalità consente agli autori di Quick Sight di risparmiare tempo e crea un'esperienza tematica standardizzata per i lettori di dashboard su più dashboard. Per migrare gli argomenti con la CLI Quick Sight, utilizzare la seguente procedura **Per migrare un argomento su un altro account** 1. Innanzitutto, identifica l'argomento che desideri migrare. Puoi visualizzare un elenco di tutti gli argomenti nel tuo account Quick con un comando `list-topics` API. ``` aws quicksight list-topics --aws-account-id AWSACCOUNTID ``` 1. Dopo aver creato un elenco di argomenti, individua l'argomento che desideri migrare ed effettua una `describe-topic` chiamata per ricevere una struttura JSON della configurazione dell'argomento. ``` aws quicksight describe-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` Di seguito è riportata un esempio di risposta API di `describe-topic`. ``` { "Status": 200, "TopicId": "TopicExample", "Arn": "string", "Topic": [ { "Name": "{}", "DataSets": [ { "DataSetArn": "{}", "DataSetName": "{}", "DataSetDescription": "{}", "DataAggregation": "{}", "Filters": [], "Columns": [], "CalculatedFields": [], "NamedEntities": [] } ] } ], "RequestId": "requestId" } ``` 1. Usa la risposta JSON per creare un file scheletro da inserire in una nuova `create-topic` chiamata nell'altro account Quick. Prima di effettuare una chiamata API con il file skeleton, assicurati di modificare l' Account AWS ID e l'ID del set di dati nel file skeleton in modo che corrispondano all' Account AWS ID e all'ID del set di dati a cui stai aggiungendo il nuovo argomento. Per ulteriori informazioni sui file scheletro della CLI, consulta Using [CLI skeleton files nella *Amazon* Quick](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) Sight Developer Guide. ``` aws quicksight create-topic --aws-account-id AWSACCOUNTID \ --cli-input-json file://./create-topic-cli-input.json ``` Dopo aver effettuato una `create-topic` chiamata all'API Quick Sight, il nuovo argomento viene visualizzato nel tuo account. Per confermare l'esistenza del nuovo argomento, effettua una `list-topics` chiamata all'API Quick Sight. Se l'argomento di origine che è stato duplicato contiene risposte verificate, le risposte non vengono migrate al nuovo argomento. Per visualizzare un elenco di tutte le risposte verificate configurate in base all'argomento originale, utilizza una chiamata API `describe-topic`. # Crea e modifica le risposte riviste negli argomenti di Quick Sight con Quick Sight APIs Dopo aver creato un argomento Quick Sight, puoi utilizzare Quick Sight APIs per creare, elencare, aggiornare ed eliminare le risposte riviste agli argomenti. Il comando seguente crea in batch fino a 100 risposte riviste per un argomento di Quick Sight. ``` aws quicksight batch-create-topic-reviewed-answer \ --topic-id TOPICID \ --aws-account-id AWSACCOUNTID \ —answers ANSWERS ``` È inoltre possibile creare in batch le risposte revisionate da un file scheletro della CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Using [CLI skeleton files nella *Amazon* Quick](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) Sight Developer Guide. ``` aws quicksight batch-create-topic-reviewed-answer \ --cli-input-json file://createTopicReviewedAnswer.json ``` Il comando seguente elenca tutte le risposte esaminate in un argomento di Quick Sight. ``` aws quicksight list-topic-reviewed-answers \ --aws-account-id AWSACCOUNTID \ --topic-id TOPICID \ ``` L'esempio seguente elimina in batch un massimo di 100 risposte revisionate da un argomento. ``` aws quicksight batch-delete-topic-reviewed-answer \ --topic-id TOPICID \ --aws-account-id AWSACCOUNTID \ —answer-ids: ["AnswerId1, AnswerId2…"] ``` È inoltre possibile creare in batch le risposte revisionate di un argomento da un file scheletro della CLI con il seguente comando. Per ulteriori informazioni sui file scheletro della CLI, consulta Using [CLI skeleton files nella *Amazon* Quick](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) Sight Developer Guide. ``` aws quicksight batch-delete-topic-reviewed-answer \ --cli-input-json file://deleteTopicReviewedAnswer.json ``` Per aggiornare una risposta revisionata, elimina la risposta esistente dall'argomento con l'API `batch-delete-topic-reviewed-answer`. Quindi, utilizza l'API `batch-create-topic-reviewed-answer` per aggiungere la risposta revisionata aggiornata all'argomento.