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à. # Usa l'API X-Ray Se l'SDK X-Ray non supporta il tuo linguaggio di programmazione, puoi utilizzare APIs direttamente X-Ray o AWS Command Line Interface ()AWS CLI per richiamare i comandi dell'API X-Ray. Utilizza le seguenti indicazioni per scegliere come interagire con l'API: + Utilizza la sintassi AWS CLI per una sintassi più semplice utilizzando comandi preformattati o con opzioni all'interno della richiesta. + Utilizza direttamente l'API X-Ray per la massima flessibilità e personalizzazione per le richieste che invii a X-Ray. Se si utilizza direttamente l'[API X-Ray](https://docs.aws.amazon.com/xray/latest/api/Welcome.html) anziché AWS CLI, è necessario parametrizzare la richiesta nel formato di dati corretto e potrebbe anche essere necessario configurare l'autenticazione e la gestione degli errori. Il diagramma seguente mostra le linee guida per scegliere come interagire con l'API X-Ray: ![X-Ray visualizza informazioni dettagliate sulle richieste delle applicazioni.](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/api-vs-cli.png) Utilizza l'API X-Ray per inviare i dati di traccia direttamente a X-Ray. L'API X-Ray supporta tutte le funzioni disponibili in X-Ray SDK, incluse le seguenti azioni comuni: + [PutTraceSegments](https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html)— Carica i documenti dei segmenti su X-Ray. + [BatchGetTraces](https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html)— Recupera un elenco di tracce in un elenco di tracce. IDs Ogni traccia recuperata è una raccolta di documenti di segmento provenienti da una singola richiesta. + [GetTraceSummaries](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html)— Recupera IDs e annota le tracce. È possibile specificare `FilterExpression` a per recuperare un sottoinsieme di riepiloghi delle tracce. + [GetTraceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html)— Recupera un grafico di servizio per un ID di traccia specifico. + [GetServiceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html)— Recupera un JSON documento formattato che descrive i servizi che elaborano le richieste in entrata e le chiamano le richieste a valle. Puoi anche usare il AWS Command Line Interface (AWS CLI) all'interno del codice dell'applicazione per interagire a livello di codice con X-Ray. AWS CLI Supporta tutte le funzioni disponibili nell'X-Ray SDK, comprese quelle per altri. Servizi AWS Le seguenti funzioni sono versioni delle operazioni API elencate in precedenza con un formato più semplice: + [put-trace-segments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/put-trace-segments.html)— Carica i documenti dei segmenti su X-Ray. + [batch-get-traces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/batch-get-traces.html)— Recupera un elenco di tracce in un elenco di tracce. IDs Ogni traccia recuperata è una raccolta di documenti di segmento provenienti da una singola richiesta. + [get-trace-summaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-summaries.html)— Recupera IDs e annota le tracce. È possibile specificare `FilterExpression` a per recuperare un sottoinsieme di riepiloghi delle tracce. + [get-trace-graph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-graph.html)— Recupera un grafico di servizio per un ID di traccia specifico. + [get-service-graph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-service-graph.html)— Recupera un documento `JSON` formattato che descrive i servizi che elaborano le richieste in entrata e chiamano le richieste a valle. Per iniziare, è necessario installare il file [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)per il proprio sistema operativo. AWS supporti Linux, macOS e Windows sistemi operativi. Per ulteriori informazioni sull'elenco dei comandi X-Ray, vedere la [guida di riferimento ai AWS CLI comandi per X-Ray](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/index.html). **Topics** + [Utilizzo dell' AWS X-Ray API con la AWS CLI](xray-api-tutorial.md) + [Invio di dati di tracciamento a AWS X-Ray](xray-api-sendingdata.md) + [Ottenere dati da AWS X-Ray](xray-api-gettingdata.md) + [Configurazione delle impostazioni di campionamento, gruppi e crittografia con l'API AWS X-Ray](xray-api-configuration.md) + [Using sampling rules with the X-Ray API (Utilizzo delle regole di campionamento con l'API X-Ray)](xray-api-sampling.md) + [AWS X-Ray segmentare i documenti](xray-api-segmentdocuments.md)