Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisation de l'API pour Amazon EC2
Important
Depuis le 14 octobre 2022, les réponses HTTP des API Amazon EC2 n'incluent plus d'élément de phrase de motivation. Comme recommandé par la RFC7230
Nous fournissons l'API Query pour Amazon EC2, ainsi que des kits de développement logiciel (SDK) AWS qui vous permettent d'accéder à Amazon EC2 depuis votre langage de programmation préféré. Pour plus d'informations, consultez le manuel du développeur Amazon EC2.
Table des matières
Connaissances requises
Si vous prévoyez d'accéder à Amazon EC2 par le biais d'une API, vous devez connaître les éléments suivants :
-
xml
-
Services Web
-
Requêtes HTTP
-
Un ou plusieurs langages de programmation, tels que Java, PHP, Perl, Python, Ruby, C# ou C++.
API disponibles pour Amazon EC2
L'API de requête Amazon EC2 fournit des requêtes HTTP ou HTTPS qui utilisent le verbe HTTP GET ou POST et un paramètre de requête nommé. Action
AWS fournit des bibliothèques, des exemples de code, des didacticiels et d'autres ressources aux développeurs de logiciels qui préfèrent créer des applications à l'aide d'API spécifiques à un langage plutôt que de soumettre une demande via HTTP ou HTTPS. Ces bibliothèques fournissent des fonctions de base qui prennent automatiquement en charge des tâches telles que la signature cryptographique de vos demandes, les nouvelles tentatives et le traitement des réponses aux erreurs, afin que vous puissiez démarrer plus facilement.
Pour plus d'informations, consultez la section Création de ressources Amazon EC2 à l'aide d'un AWS SDK dans le manuel du développeur Amazon EC2.
Paramètres de requête courants
La plupart des actions d'API Amazon EC2 prennent en charge les paramètres décrits dans les tableaux suivants. Les paramètres courants varient selon que vous utilisez Signature version 2 ou Signature version 4 pour signer vos demandes. Pour plus d'informations, consultez la section Signature des demandes AWS d'API dans le guide de l'utilisateur IAM.
Paramètres de la version 4 de signature
| Nom | Description | Obligatoire |
|---|---|---|
|
|
L'action à effectuer. Exemple : |
Oui |
|
|
Version de l'API à utiliser. |
Oui |
|
|
L'algorithme de hachage que vous utilisez pour créer la signature de la demande. Exemple : |
Oui |
|
|
L'étendue des informations d'identification pour la demande, au format Exemple : |
Oui |
|
|
Date et heure auxquelles la demande est signée, au format YYYYMMDDTHHMMSSZ. La date doit correspondre à la date incluse dans la portée des informations d'identification pour le Exemple : |
Oui |
X-Amz-SignedHeaders |
Les en-têtes que vous incluez dans le cadre de la demande. Vous devez au minimum inclure l' Exemple : |
Oui |
|
|
Une signature dérivée de votre clé d'accès secrète. Exemple : |
Oui |
|
|
Le jeton de sécurité temporaire obtenu par un appel à AWS Security Token Service. Exemple : |
Non |
|
|
Vérifie si vous disposez des autorisations requises pour l'action, sans réellement en faire la demande. Si vous disposez des autorisations requises, la demande est renvoyée |
Non |
Les X-Amz-Signature paramètres X-Amz-AlgorithmX-Amz-Credential,X-Amz-SignedHeaders, et peuvent être spécifiés en tant que paramètres distincts dans la chaîne de requête ou leurs valeurs peuvent être incluses dans un seul Authorization en-tête. Pour plus d'informations, consultez la section Signature des demandes AWS d'API dans le guide de l'utilisateur IAM.
Paramètres de la version 2 de Signature
| Nom | Description | Obligatoire |
|---|---|---|
|
|
L'action à effectuer. Exemple : |
Oui |
|
|
Version de l'API à utiliser. |
Oui |
|
|
ID de clé d'accès pour l'expéditeur de la demande. Cela identifie le compte qui sera débité pour l'utilisation du service. Le compte associé à l'ID de clé d'accès doit être inscrit à Amazon EC2, sinon la demande n'est pas acceptée. Exemple : |
Oui |
|
|
Date et heure auxquelles la signature incluse dans la demande expire, dans le format YYYY-MM-DDThh:mm:ssZ. Pour plus d'informations, consultez ISO 8601 Exemple : |
Conditionnelle. Les demandes doivent inclure l'un Timestamp ou l'autreExpires, mais ne peuvent pas contenir les deux. |
|
|
Date et heure auxquelles la demande est signée, dans le format YYYY-MM-DDThh:mm:ssZ. Pour plus d'informations, consultez ISO 8601 Exemple : |
Conditionnelle. Les demandes doivent inclure l'un Timestamp ou l'autreExpires, mais ne peuvent pas contenir les deux. |
|
|
Signature de la demande. Exemple : |
Oui |
|
|
L'algorithme de hachage que vous utilisez pour créer la signature de la demande. Valeurs valides : Exemple : |
Oui |
|
|
Version de signature que vous utilisez pour signer la demande. Définissez cette valeur à Exemple : |
Oui |
|
|
Vérifie si vous disposez des autorisations requises pour l'action, sans réellement en faire la demande. Si vous disposez des autorisations requises, la demande est renvoyée |
Non |
|
|
Le jeton de sécurité temporaire obtenu par un appel à AWS Security Token Service. Exemple : |
Non |
Les valeurs des paramètres doivent être URL-encoded. Cela est vrai pour tout paramètre de requête transmis à Amazon EC2 et est généralement nécessaire dans le Signature paramètre. Certains clients le font automatiquement, mais ce n'est pas la norme.
