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' X-Ray API Se l' X-Ray SDK non supporta il tuo linguaggio di programmazione, puoi utilizzare direttamente le X-Ray API o AWS Command Line Interface (AWS CLI) per chiamare i comandi X-Ray API. Usa le seguenti linee guida per scegliere come interagire con l'API: + Utilizza AWS CLI la sintassi più semplice utilizzando comandi preformattati o con opzioni all'interno della richiesta. + Usa direttamente l' X-Ray API per la massima flessibilità e personalizzazione delle richieste che invii. X-Ray Se si utilizza [ direttamente l'](https://docs.aws.amazon.com/xray/latest/api/Welcome.html)X-Ray API anziché il 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' X-RayAPI: ![X-Ray visualizza informazioni dettagliate sulle richieste delle applicazioni.](https://docs.aws.amazon.com/it_it/xray/latest/devguide/images/api-vs-cli.png) Utilizza l' X-Ray API per inviare i dati di tracciamento direttamente a X-Ray. L' X-Ray API supporta tutte le funzioni disponibili nell' 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 in. X-Ray + [BatchGetTraces](https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html)— Recupera un elenco di tracce in un elenco di ID di traccia. Ogni traccia recuperata è una raccolta di documenti segmentati da una singola richiesta. + [GetTraceSummaries](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html)— Recupera gli ID e le annotazioni per 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 del servizio per un ID di traccia specifico. + [GetServiceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html)— Recupera un documento JSON formattato che descrive i servizi che elaborano le richieste in arrivo e chiamano le richieste a valle. È inoltre possibile utilizzare la AWS Command Line Interface (AWS CLI) all'interno del codice dell'applicazione per interagire in modo programmatico. X-Ray AWS CLI Supporta tutte le funzioni disponibili nell' X-Ray SDK, incluse 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 in. X-Ray + [batch-get-trace ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/batch-get-traces.html) — Recupera un elenco di tracce in un elenco di ID di traccia. Ogni traccia recuperata è una raccolta di documenti segmentati da una singola richiesta. + [get-trace-summaries: recupera gli ID e le annotazioni per ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-summaries.html) le tracce. È possibile specificare a per recuperare un sottoinsieme di riepiloghi `FilterExpression` delle tracce. + [get-trace-graph ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-graph.html) — Recupera un grafico del 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 arrivo e chiamano le richieste a valle. Per iniziare, devi installare il file per il tuo sistema operativo. [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) AWS supporti Linux macOS e sistemi Windows operativi. Per ulteriori informazioni sull'elenco dei X-Ray comandi, consulta 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)