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à.
Utilizzo dell'API per Amazon EC2
Importante
A partire dal 14 ottobre 2022, le risposte HTTP delle API di Amazon EC2 non includono più un elemento reason-phrase. Come consigliato da RFC7230
Forniamo l'API Query per Amazon EC2, oltre ai kit di sviluppo software (SDK) AWS che ti consentono di accedere ad Amazon EC2 dal tuo linguaggio di programmazione preferito. Per ulteriori informazioni, consulta la Amazon EC2 Developer Guide.
Indice
Competenze richieste
Se prevedi di accedere ad Amazon EC2 tramite un'API, dovresti conoscere quanto segue:
-
XML
-
Servizi Web
-
Richieste HTTP
-
Uno o più linguaggi di programmazione, come Java, PHP, Perl, Python, Ruby, C# o C++.
API disponibili per Amazon EC2
L'API Query di Amazon EC2 fornisce richieste HTTP o HTTPS che utilizzano il verbo HTTP GET o POST e un parametro Query denominato. Action
AWS fornisce librerie, codice di esempio, tutorial e altre risorse per gli sviluppatori di software che preferiscono creare applicazioni utilizzando API specifiche del linguaggio anziché inviare una richiesta tramite HTTP o HTTPS. Queste librerie forniscono funzioni di base che si occupano automaticamente di attività come la firma crittografica delle richieste, il ritentativo delle richieste e la gestione delle risposte agli errori, in modo che sia più facile iniziare.
Per ulteriori informazioni, consulta Creare risorse Amazon EC2 utilizzando un AWS SDK nella Amazon EC2 Developer Guide.
Parametri di query comuni
La maggior parte delle azioni API di Amazon EC2 supporta i parametri descritti nelle tabelle seguenti. I parametri comuni variano a seconda che tu stia utilizzando Signature Version 2 o Signature Version 4 per firmare le tue richieste. Per ulteriori informazioni, consulta Signing AWS API request nella IAM User Guide.
Parametri per la versione 4 di Signature
| Nome | Description | Richiesto |
|---|---|---|
|
|
L'azione da eseguire. Ad esempio: |
Sì |
|
|
La versione dell'API di da utilizzare. |
Sì |
|
|
L'algoritmo hash utilizzato per creare la firma della richiesta. Ad esempio: |
Sì |
|
|
L'ambito delle credenziali per la richiesta, nel formato Ad esempio: |
Sì |
|
|
La data e l'ora in cui viene firmata la richiesta, nel formato YYYYMMDDthHmmssz. La data deve corrispondere alla data inclusa nell'ambito delle credenziali per il Ad esempio: |
Sì |
X-Amz-SignedHeaders |
Le intestazioni che includi come parte della richiesta. Come minimo, è necessario includere l' Ad esempio: |
Sì |
|
|
Una firma derivata dalla tua chiave di accesso segreta. Ad esempio: |
Sì |
|
|
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service. Ad esempio: |
No |
|
|
Verifica se si dispone delle autorizzazioni necessarie per l'azione, senza effettuare effettivamente la richiesta. Se si dispone delle autorizzazioni richieste, la richiesta viene restituita |
No |
I X-Amz-Signature parametri X-Amz-AlgorithmX-Amz-Credential,X-Amz-SignedHeaders, e possono essere specificati come parametri separati nella stringa di query oppure i relativi valori possono essere inclusi in un'unica Authorization intestazione. Per ulteriori informazioni, consulta Signing AWS API request nella IAM User Guide.
Parametri per la versione 2 di Signature
| Nome | Description | Richiesto |
|---|---|---|
|
|
L'azione da eseguire. Ad esempio: |
Sì |
|
|
La versione dell'API di da utilizzare. |
Sì |
|
|
L'ID della chiave di accesso per il mittente della richiesta. Identifica l'account a cui verrà addebitato l'utilizzo del servizio. L'account associato all'ID della chiave di accesso deve essere registrato per Amazon EC2, altrimenti la richiesta non viene accettata. Ad esempio: |
Sì |
|
|
La data e l'ora in cui scade la firma inclusa nella richiesta, nel formato. YYYY-MM-DDThh:mm:ssZ Per ulteriori informazioni, consulta il protocollo ISO 8601 Ad esempio: |
Condizionale. Le richieste devono includere una delle due Timestamp o Expires non possono contenere entrambe. |
|
|
La data e l'ora in cui viene firmata la richiesta, nel formato YYYY-MM-DDThh:mm:ssZ. Per ulteriori informazioni, consulta il protocollo ISO 8601 Ad esempio: |
Condizionale. Le richieste devono includere uno Timestamp o entrambiExpires, ma non possono contenerli entrambi. |
|
|
La firma della richiesta. Ad esempio: |
Sì |
|
|
L'algoritmo hash utilizzato per creare la firma della richiesta. Valori validi: Ad esempio: |
Sì |
|
|
Versione della firma da utilizzare per firmare la richiesta. Imposta questo valore su Ad esempio: |
Sì |
|
|
Verifica se disponi delle autorizzazioni necessarie per l'azione, senza effettuare effettivamente la richiesta. Se si dispone delle autorizzazioni richieste, la richiesta viene restituita |
No |
|
|
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service. Ad esempio: |
No |
I valori dei parametri devono essere URL-encoded. Questo vale per qualsiasi parametro di Query passato ad Amazon EC2 ed è in genere necessario nel Signature parametro. Alcuni client lo fanno automaticamente, ma questa non è la norma.