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

# Chiamata dell'API tramite richieste di query HTTP
<a name="orgs_query-requests"></a>

Questa sezione contiene informazioni generali sull'utilizzo dell'API Query per AWS Organizations. Per ulteriori informazioni sulle operazioni delle API e sugli errori, consulta la [documentazione di riferimento delle API di AWS Organizations](https://docs.aws.amazon.com/organizations/latest/APIReference/).

**Nota**  
Invece di effettuare chiamate dirette all'API AWS Organizations Query, puoi utilizzare uno dei AWS SDKs. AWS SDKs Sono costituiti da librerie e codice di esempio per vari linguaggi e piattaforme di programmazione (Java, Ruby, .NET, iOS, Android e altri). SDKs Forniscono un modo conveniente per creare un accesso programmatico a AWS Organizations e. AWS Ad esempio, SDKs si occupano di attività come la firma crittografica delle richieste, la gestione degli errori e il ritentativo automatico delle richieste. Per informazioni su AWS SDKs, incluso come scaricarli e installarli, consulta [Tools for Amazon Web Services](https://aws.amazon.com/tools/).

L'API Query per AWS Organizations ti consente di richiamare azioni di servizio. Le richieste API di query sono richieste HTTPS che devono contenere un `Action` parametro per indicare l'operazione da eseguire. AWS Organizations supporta le richieste GET e POST per tutte le operazioni. Questo significa che l'API non richiede l'uso di GET per alcune operazioni e di POST per altre. Tuttavia, le richieste GET sono soggette alla limitazione delle dimensioni di un URL. Benché questo limite dipenda dal browser, un limite tipico è 2048 byte. Di conseguenza, per le richieste API Query che richiedono dimensioni maggiori, devi usare una richiesta POST.

La risposta è un documento XML. Per ulteriori informazioni sulla risposta, consulta le pagine delle singole operazioni nella [documentazione di riferimento delle API di AWS Organizations](https://docs.aws.amazon.com/organizations/latest/APIReference/).

**Topics**
+ [Endpoints](#OrgsEndpoints)
+ [HTTPS obbligatorio](#IAMHTTPSRequired)
+ [Firma AWS Organizations delle richieste API](#SigVersion)

## Endpoints
<a name="OrgsEndpoints"></a>

AWS Organizations dispone di un unico endpoint API globale ospitato nella regione Stati Uniti orientali (Virginia settentrionale).

Per ulteriori informazioni sugli AWS endpoint e sulle regioni per tutti i servizi, consulta [Endpoint regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) nel. *Riferimenti generali di AWS* 

## HTTPS obbligatorio
<a name="IAMHTTPSRequired"></a>

Poiché l'API Query restituisce informazioni sensibili, ad esempio le credenziali di sicurezza, devi usare HTTPS per crittografare tutte le richieste API. 

## Firma AWS Organizations delle richieste API
<a name="SigVersion"></a>

Le richieste devono essere firmate usando un ID chiave di accesso e una Secret Access Key. Ti consigliamo vivamente di non utilizzare Utente root dell'account AWS le tue credenziali per il lavoro quotidiano con AWS Organizations. È possibile utilizzare le credenziali di un utente o un ruolo.

Per firmare le tue richieste API, devi utilizzare AWS Signature Version 4. Per informazioni sull'utilizzo della versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.

AWS Organizations non supporta versioni precedenti, come Signature Version 2.

Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [AWS Credenziali di sicurezza](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html): fornisce informazioni generali sui tipi di credenziali che è possibile utilizzare per accedere. AWS
+ [Best practice di sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html): offre suggerimenti per l'utilizzo del servizio IAM per proteggere le AWS risorse, incluse quelle in. AWS Organizations
+ [Credenziali di sicurezza temporanee in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html): descrive come creare e usare credenziali di sicurezza temporanee.